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5.3.1.7 Method status 461 

5.3.1.7.1 Conformance requirement 461 

5.3.1.7.2 Test area files 462 

5.3.1.7.3 Test coverage 462 

5.3.1.7.4 Test procedure 463 

5.3.1.8 Method readBinary 464 

5.3.1.8.1 Conformance requirement 464 

5.3.1.8.2 Test area files 465 

5.3.1.8.3 Test coverage 465 

5.3.1.8.4 Test procedure 465 

5.3.1.9 Method updateBinary 466 

5.3.1.9.1 Conformance requirement 466 

5.3.1.9.2 Test area files 467 

5.3.1.9.3 Test coverage 467 

5.3.1.9.4 Test procedure 468 

5.3.1.10 Method readRecord 469 

5.3.1.10.1 Conformance requirement 469 

5.3.1.10.2 Test area files 471 
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5.3.1.10.3 Test coverage 471 

5.3.1.10.4 Test procedure 471 

5.3.1.11 Method updateRecord 475 

5.3.1.11.1 Conformance requirement 475 

5.3.1.11.2 Test area files 477 

5.3.1.11.3 Test coverage 477 

5.3.1.11.4 Test procedure 478 

5.3.1.12 Method searchRecord 482 

5.3.1.12.1 Conformance requirement 482 

5.3.1.12.2 Test area files 484 

5.3.1.12.3 Test coverage 484 

5.3.1.12.4 Test procedure 484 

5.3.1.13 Method increase 495 

5.3.1.13.1 Conformance requirement 495 

5.3.1.13.2 Test areafiles 496 

5.3.1.13.3 Test coverage 496 

5.3.1.13.4 Test procedure 496 

5.3.1.14 Method deactivateFile 499 

5.3.1.14.1 Conformance requirement 499 

5.3.1.14.2 Test area files 500 

5.3.1.14.3 Test coverage 500 

5.3.1.14.4 Test procedure 500 

5.3.1.15 Method activateFile 500 

5.3.1.15.1 Conformance requirement 500 

5.3.1.15.2 Test area files 501 

5.3.1.15.3 Test coverage 501 

5.3.1.15.4 Test procedure 501 

5.3.2 Class AdminFileViewBuilder 502 

5.3.2.1 Method getTheUICCAdminPile View 502 

5.3.2.1.1 Conformance requirement 502 

5.3.2.1.2 Test area files 502 

5.3.2.1.3 Test coverage 503 

5.3.2.1.4 Test procedure 503 

5.3.2.2 Method getTheAdminFileView(javacard.framework.AID aid, byte event) 505 

5.3.2.2.1 Conformance requirement: 505 

5.3.2.2.2 Test area files 506 

5.3.2.2.3 Test coverage 506 

5.3.2.2.4 Test procedure 506 

5.3.2.3 Method getTheAdminFileView(byte[] buffer, short bOffset, short bLength, byte event) 509 

5.3.2.3.1 Conformance requirement: 509 

5.3.2.3.2 Test area files 510 

5.3.2.3.3 Test coverage 510 

5.3.2.3.4 Test procedure 511 

5.3.3 Class AdminException 514 

5.3.3.1 Constructor 514 

5.3.3.1.1 Conformance requirement 514 

5.3.3.1.2 Test area files 514 

5.3.3.1.3 Test coverage 515 

5.3.3.1.4 Test procedure 515 

5.3.3.2 Method throwit 515 

5.3.3.2.1 Conformance requirement 515 

5.3.3.2.2 Test area files 515 

5.3.3.2.3 Test coverage 515 

5.3.3.2.4 Test procedure 516 

5.3.3.3 Reason Codes 516 

5.3.3.3.1 Conformance Requirement: 516 

5.3.3.3.2 Test area files 516 

5.3.3.3.3 Test Coverage 516 

5.3.3.3.4 Test Procedure 516 

5.4 Package uicc. system 517 

5.4.1 Class HandlerBuilder 517 

5.4.1.1 Method buildTLVHandler(byte type, short capacity) 517 
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5.4.1.1.1 Conformance requirement 517 

5.4.1.1.2 Test area files 517 

5.4.1.1.3 Test coverage 517 

5.4.1.1.4 Test procedure 518 

5.4.1.2 Method buildTLVHandler(byte type, short capacity, byte[] buffer , short bOffset, short bLength) ...518 

5.4.1.2.1 Conformance requirement 518 

5.4.1.2.2 Test area files 519 

5.4.1.2.3 Test coverage 519 

5.4.1.2.4 Test procedure 519 

5.4.2 Interface UlCCPlatfbrm 521 

5.4.2.1 Method getTheVolatileByteArray 521 

5.4.2.1.1 Conformance requirement 521 

5.4.2.1.2 Test area files 521 

5.4.2.1.3 Test coverage 521 

5.4.2.1.4 Test procedure 522 

5.5 CAT Runtime Environment 523 

5.5.1 Minimum Handler Availability 523 

5.5.1.1 ProactiveHandler 523 

5.5.1.1.1 Conformance requirement 523 

5.5.1.1.2 Test area files 524 

5.5.1.1.3 Test coverage 524 

5.5.1.1.4 Test procedure 525 

5.5.1.2 ProactiveResponseHandler 538 

5.5.1.2.1 Conformance requirement 538 

5.5.1.2.2 Test area files 540 

5.5.1.2.3 Test coverage 540 

5.5.1.2.4 Test procedure 540 

5.5.1.3 EnvelopeHandler 558 

5.5.1.3.1 Conformance requirement 558 

5.5.1.3.2 Test area files 559 

5.5.1.3.3 Test coverage 559 

5.5.1.3.4 Test procedure 560 

5.5.1.4 EnvelopeResponseHandler 566 

5.5.1.4.1 Conformance requirement 566 

5.5.1.4.2 Test area files 567 

5.5.1.4.3 Test coverage 567 

5.5.1.4.4 Test procedure 568 

5.5.2 Handler Integrity 575 

5.5.2.1 ProactiveHandler 575 

5.5.2.1.1 Conformance requirement 575 

5.5.2.1.2 Test area files 575 

5.5.2.1.3 Test coverage 575 

5.5.2.1.4 Test procedure 576 

5.5.2.2 ProactiveResponseHandler 577 

5.5.2.2.1 Conformance requirement 577 

5.5.2.2.2 Test area files 578 

5.5.2.2.3 Test coverage 578 

5.5.2.2.4 Test procedure 578 

5.5.2.3 EnvelopeHandler 579 

5.5.2.3.1 Conformance requirement 579 

5.5.2.3.2 Test area files 580 

5.5.2.3.3 Test coverage 580 

5.5.2.3.4 Test procedure 581 

5.5.2.4 EnvelopeResponseHandler 603 

5.5.2.4.1 Conformance requirement 603 

5.5.2.4.2 Test area files 604 

5.5.2.4.3 Test coverage 604 

5.5.2.4.4 Test procedure 604 

5.5.3 Applet Triggering 604 

5.5.3.1 General behaviour 604 

5.5.3.1.1 Conformance requirement 604 

5.5.3.1.2 Test area files 605 
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Test coverage 605 

Test procedure 605 

EVENT_PROFILE_DOWNLOAD 605 

Conformance requirement 605 

Test area files 606 

Test coverage 606 

Test procedure 606 

EVENT_MENU_SELECTION 607 

Conformance requirement 607 

Test area files 608 

Test coverage 608 

Test procedure 608 

EVENT_MENU_SELECTION_HELP_REQUEST 609 

Conformance requirement 609 

Test area files 609 

Test coverage 609 

Test procedure 610 

EVENT_CALL_CONTROL_BY_NAA 612 

Conformance requirement 612 

Test area files 612 

Test coverage 612 

Test procedure 613 

EVENT_TIMER_EXPIRATION 613 

Conformance requirement 613 

Test area files 614 

Test coverage 614 

Test procedure 614 

EVENT_EVENT_DOWNLOAD_MT_CALL 614 

Conformance requirement 614 

Test area files 615 

Test coverage 615 

Test procedure 615 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 616 

Conformance requirement 616 

Test area files 616 

Test coverage 616 

Test procedure 617 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 617 

Conformance requirement 617 

Test area files 618 

Test coverage 618 

Test procedure 618 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 619 

Conformance requirement 619 

Test area files 619 

Test coverage 619 

Test procedure 619 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 620 

Conformance requirement 620 

Test area files 620 

Test coverage 620 

Test procedure 621 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 621 

Conformance requirement 621 

Test area files 621 

Test coverage 622 

Test procedure 622 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 622 

Conformance requirement 622 

Test area files 623 

Test coverage 623 

Test procedure 623 
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5.5.3.14 EVENT_UNRECOGNIZED_ENVELOPE 624 

5.5.3.14.1 Conformance requirement 624 

5.5.3.14.2 Test area files 624 

5.5.3.14.3 Test coverage 624 

5.5.3.14.4 Test procedure 624 

5.5.3.15 EVENT_STATUS_COMMAND 625 

5.5.3.15.1 Conformance requirement 625 

5.5.3.15.2 Test area files 625 

5.5.3.15.3 Test coverage 625 

5.5.3.15.4 Test procedure 626 

5.5.3.16 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECT10N 627 

5.5.3.16.1 Conformance requirement 627 

5.5.3.16.2 Test area files 627 

5.5.3.16.3 Test coverage 627 

5.5.3.16.4 Test procedure 627 

5.5.3.17 EVENT_EVENT_DOWNLOAD_BROWSER_TERMlNAT10N 628 

5.5.3.17.1 Conformance requirement 628 

5.5.3.17.2 Test area files 628 

5.5.3.17.3 Test coverage 628 

5.5.3.17.4 Test procedure 629 

5.5.3.18 EVENT_F1RST_C0MMAND_AFTER_ATR 629 

5.5.3.18.1 Conformance requirement 629 

5.5.3.18.2 Test area files 630 

5.5.3.18.3 Test coverage 630 

5.5.3.18.4 Test procedure 630 

5.5.3.19 EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 631 

5.5.3.19.1 Conformance requirement 631 

5.5.3.19.2 Test area files 632 

5.5.3.19.3 Test coverage 632 

5.5.3.19.4 Test procedure 633 

5.5.3.20 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 635 

5.5.3.20.1 Conformance requirement 635 

5.5.3.20.2 Test area files 635 

5.5.3.20.3 Test coverage 635 

5.5.3.20.4 Test procedure 636 

5.5.3.21 EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 638 

5.5.3.21.1 Conformance requirement 638 

5.5.3.21.2 Test area files 638 

5.5.3.21.3 Test coverage 638 

5.5.3.21.4 Test procedure 638 

5.5.3.22 EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 639 

5.5.3.22.1 Conformance requirement 639 

5.5.3.22.2 Test area files 639 

5.5.3.22.3 Test coverage 639 

5.5.3.22.4 Test procedure 640 

5.5.3.23 EVENT_EVENT_DOWNLOAD_LOCAL_CONNECT10N 640 

5.5.3.23.1 Conformance requirement 640 

5.5.3.23.2 Test area files 641 

5.5.3.23.3 Test coverage 641 

5.5.3.23.4 Test procedure 642 

5.5.3.24 EVENT_APPL1CAT10N_DESELECT 643 

5.5.3.24.1 Conformance requirement 643 

5.5.3.24.2 Test area files 644 

5.5.3.24.3 Test coverage 644 

5.5.3.24.4 Test procedure 644 

5.5.3.25 EVENT_PROACTIVE_HANDLER_AVAILABLE 645 

5.5.3.25.1 Conformance requirement 645 

5.5.3.25.2 Test area files 646 

5.5.3.25.3 Test coverage 646 

5.5.3.25.4 Test procedure 647 

5 .5 .3 .26 E VENT_E VENT_DOWNLOAD_NETWORK_SEARCH_MODE_CH ANGE 648 

5.5.3.26.1 Conformance requirement 648 
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5.5.3.26.2 Test area files 648 

5.5.3.26.3 Test coverage 648 

5.5.3.26.4 Test procedure 649 

5.5.3.27 EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 649 

5.5.3.27.1 Conformance requirement 649 

5.5.3.27.2 Test area files 650 

5.5.3.27.3 Test coverage 650 

5.5.3.27.4 Test procedure 650 

5.5.3.28 EVENT_EXTERNAL_FILE_UPDATE 651 

5.5.3.28.1 Conformance requirement 651 

5.5.3.28.2 Test area files 651 

5.5.3.28.3 Test coverage 651 

5.5.3.28.4 Test procedure 652 

5.5.4 Proactive Command Sending by the CAT Runtime Environment 653 

5.5.4.1 System Proactive Commands 653 

5.5.4.1.1 Conformance requirement 653 

5.5.4.1.2 Test area files 654 

5.5.4.1.3 Test coverage 654 

5.5.4.1.4 Test procedure 655 

5.5.4.2 Interaction with GSM commands 659 

5.5.4.2.1 Conformance requirement 659 

5.5.4.2.2 Test area files 659 

5.5.4.2.3 Test coverage 659 

5.5.4.2.4 Test procedure 660 

5.5.4.3 Proactive Command Control 661 

5.5.4.3.1 Conformance requirement 661 

5.5.4.3.2 Test area files 662 

5.5.4.3.3 Test coverage 662 

5.5.4.3.4 Test procedure 662 

5.5.5 Exception Handling 665 

5.5.5.1 General Behaviour 665 

5.5.5.1.1 Conformance requirement 665 

5.5.5.1.2 Test area files 666 

5.5.5.1.3 Test coverage 666 

5.5.5.1.4 Test procedure 666 

5.5.5.2 Interaction with Multiple Triggering 667 

5.5.5.2.1 Conformance requirement 667 

5.5.5.2.2 Test area files 667 

5.5.5.2.3 Test coverage 667 

5.5.5.2.4 Test procedure 668 

5.5.6 Envelope Response Posting 668 

5.5.6.1 General Behaviour 668 

5.5.6.1.1 Conformance requirement 668 

5.5.6.1.2 Test area files 669 

5.5.6.1.3 Test coverage 669 

5.5.6.1.4 Test procedure 669 

5.5.6.2 EVENT_CALL_CONTROL_BY_NAA 669 

5.5.6.2.1 Conformance requirement 669 

5.5.6.2.2 Test area files 669 

5.5.6.2.3 Test coverage 669 

5.5.6.2.4 Test procedure 670 

5.5.6.3 EVENT_UNRECOGNIZED_ENVELOPE 670 

5.5.6.3.1 Conformance requirement 670 

5.5.6.3.2 Test area files 671 

5.5.6.3.3 Test coverage 671 

5.5.6.3.4 Test procedure 671 

5.5.7 Toolkit Installation 671 

5.5.7.1 General Behaviour 671 

5.5.7.1.1 Conformance requirement 671 

5.5.7.1.2 Test area files 672 

5.5.7.1.3 Test coverage 672 

5.5.7.1.4 Test procedure 672 
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5.5.7.2 Timers Allocation 672 

5.5.7.2.1 Conformance requirement 672 

5.5.7.2.2 Test area files 673 

5.5.7.2.3 Test coverage 673 

5.5.7.2.4 Test procedure 673 

5.5.7.3 Item Identifier 674 

5.5.7.3.1 Conformance requirement 674 

5.5.7.3.2 Test area files 674 

5.5.7.3.3 Test coverage 674 

5.5.7.3.4 Test procedure 675 

5.5.7.4 Item Position 676 

5.5.7.4.1 Conformance requirement 676 

5.5.7.4.2 Test area files 676 

5.5.7.4.3 Test coverage 677 

5.5.7.4.4 Test procedure 677 

5.5.7.5 Maximum Text Length for a menu entry 680 

5.5.7.5.1 Conformance requirement 680 

5.5.7.5.2 Test area files 681 

5.5.7.5.3 Test coverage 681 

5.5.7.5.4 Test procedure 681 

5.5.7.6 Maximum number of menu entries 682 

5.5.7.6.1 Conformance requirement 682 

5.5.7.6.2 Test area files 682 

5.5.7.6.3 Test coverage 682 

5.5.7.6.4 Test procedure 683 

5.5.7.7 Access Domain 683 

5.5.7.7.1 Conformance requirement 683 

5.5.7.7.2 Test area files 685 

5.5.7.7.3 Test coverage 685 

5.5.7.7.4 Test procedure 685 

5.5.7.8 Priority Level 695 

5.5.7.8.1 Conformance requirement 695 

5.5.7.8.2 Test area files 695 

5.5.7.8.3 Test coverage 695 

5.5.7.8.4 Test procedure 695 

5.5.7.9 Channel Allocation 698 

5.5.7.9.1 Conformance requirement 698 

5.5.7.9.2 Test area files 699 

5.5.7.9.3 Test coverage 699 

5.5.7.9.4 Test procedure 699 

5.5.7.10 Minimum Security Level 700 

5.5.7.10.1 Conformance requirement 700 

5.5.7.10.2 Test area files 700 

5.5.7.10.3 Test coverage 701 

5.5.7.10.4 Test procedure 701 

5.5.7.11 TAR Value(s) of the Toolkit Application instance 701 

5.5.7.11.1 Conformance requirement 701 

5.5.7.11.2 Test area files 701 

5.5.7.11.3 Test coverage 701 

5.5.7.11.4 Test procedure 702 

5.5.7.12 Services Allocation 702 

5.5.7.12.1 Conformance requirement 702 

5.5.7.12.2 Test area files 702 

5.5.7.12.3 Test coverage 702 

5.5.7.12.4 Test procedure 703 

5.5.8 UICC File Access 703 

5.5.8.1 FileView 703 

5.5.8.1.1 Conformance requirement 703 

5.5.8.1.2 Test area files 704 

5.5.8.1.3 Test coverage 704 

5.5.8.1.4 Test procedure 705 

5.5.8.2 File Access 707 
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5.5.9 Other parts transferred to framework from API 707 

5.5.9.1 A handler is a temporary JCRE Entry Point object 707 

5.5.9.1.1 Conformance requirement 707 

5.5.9.1.2 Test area files 708 

5.5.9.1.3 Test coverage 708 

5.5.9.1.4 Test procedure 708 

5.5.9.2 Transaction 709 

5.5.9.2.1 Conformance requirement 709 

5.5.9.2.2 Test area files 709 

5.5.9.2.3 Test coverage 709 

5.5.9.2.4 Test procedure 710 

5.5.9.3 Timer Id between Applets 710 

5.5.9.3.1 Conformance requirement 710 

5.5.9.3.2 Test area files 710 

5.5.9.3.3 Test coverage 711 

5.5.9.3.4 Test procedure 711 

5.5.10 Registration 711 

5.5.10.1 Event registration 711 

5.5.10.1.1 Conformance requirement 711 

5.5.10.1.2 Test area files 711 

5.5.10.1.3 Test coverage 712 

5.5.10.1.4 Test procedure 712 

5.5.11 UICC Toolkit Applet 712 

5.5.11.1 Data and function sharing 712 

5.5.11.1.3 Test coverage 713 

5.5.11.1.4 Test procedure 714 

5.5.11.2 Package deletion 714 

5.5.11.2.1 Conformance requirement 714 

5.5.11.2.2 Test area files 714 

5.5.11.2.3 Test coverage 715 

5.5.11.2.4 Test procedure 715 

5.5.11.3 Applet deletion 715 

5.5.11.3.1 Conformance requirement 716 

5.5.11.3.2 Test area files 716 

5.5.11.3.3 Test coverage 716 

5.5.11.2.4 Test procedure 717 

5.5.11.4 Object deletion 719 

5.5.11.4.1 Conformance requirement 719 

5.5.11.4.2 Test area files 719 

5.5.11.4.3 Test coverage 719 

5.5.11.4.4 Test procedure 719 

5.5.12 Proactive Command Handling 720 

5.5.12.1 General behaviour 720 

5.5.12.1.1 Conformance requirement 720 

5.5.12.1.2 Test area files 720 

5.5.12.1.3 Test coverage 720 

5.5.12.1.4 Test procedure 720 

5.5.13 CAT Runtime Environment behaviour 720 

5.5.13.1 Context 720 

5.5.13.1.1 Conformance requirement 720 

5.5.13.1.2 Test area files 721 

5.5.13.1.3 Test coverage 721 

5.5.13.1.4 Test procedure 721 

5.5.14 UICC and ADF File System Administration API 721 

5.5.14.1 AdminFile View 721 

5.5.14.1.1 Conformance requirement 721 

5.5.14.1.2 Test area files 721 

5.5.14.1.3 Test coverage 722 

5.5.14.1.4 Test procedure 722 

5.5.14.2 AdminFile Access 722 

Annex A (normative): Class and methods acronyms 723 
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A.l uicc.access package 723 

A. 1.1 File View methods 723 

A.1.2 UlCCConstants 723 

A.l. 3 UlCCSystem methods 723 

A.1.4 UlCCException methods 724 

A.2 uicc.toolkit package 724 

A.2.1 BERTLVEditHandler methods 724 

A.2.2 BERTLVViewHandler methods 725 

A.2.3 EditHandler methods 725 

A. 2. 4 EnvelopeHandler methods 725 

A. 2. 5 EnvelopeResponseHandler methods 726 

A. 2. 6 ProactiveHandler methods 726 

A.2. 7 ProactiveResponseHandler methods 727 

A.2. 8 ToolkitConstants methods 728 

A. 2. 9 Toolkitlnterface methods 728 

A.2. 10 ToolkitRegistry methods 728 

A.2.1 1 ViewHandler methods 729 

A.2. 12 EnvelopeHandlerSystem methods 729 

A.2. 13 EnvelopeResponseHandlerSystem methods 729 

A.2. 14 ProactiveHandlerSystem methods 729 

A.2. 15 ProactiveResponseHandlerSystem methods 729 

A.2. 16 TerminalProfile methods 729 

A.2. 17 ToolkitRegistrySystem methods 729 

A.2. 18 ToolkitException methods 729 

A. 3 uicc. system package 730 

A.3.1 BERTLVEditHandler methods 730 

A.3.2 UlCCPlatfbrm methods 730 

A.4 uicc. access.fileadministration package 730 

A.4.1 AdminFile View methods 730 

A.4. 2 AdminFile Vie wBuilder methods 731 

A.4. 3 AdminException methods 731 

A. 5 Acronyms for CAT Runtime Environment tests 731 

A. 5.1 Minimum handler availability 731 

A.5.2 Handler integrity 731 

A.5.3 Applet triggering 732 

A. 5. 4 Proactive command sending by the CAT Runtime Environment 732 

A.5.5 Exception handling 732 

A.5.6 Envelope response posting 732 

A. 5. 7 Toolkit installation 733 

A.5.8 UICC file access 733 

A.5.9 Other parts transferred from API to CAT RE 733 

A.5.10 Registration 733 

A.5.11 UICC toolkit applet 733 

A.5.12 Proactive command handling 733 
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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Project Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within TC SCP and may change following formal 
TC SCP approval. If TC SCP decides to modify the contents of the present document, it will be re-released by TC SCP 
with an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TC SCP for information; 

2 presented to TC SCP for approval; 

3 or greater indicates TC SCP approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide compliance to 
TS 102 241 [9]. 

It describes the technical characteristics and methods for testing the UICC API for Java Card^*^ (TS 102 241 [9]) 
implemented in a UICC Platform. It specifies the following parts: 

test applicability; 

test environment description; 

tests format; 

test area reference; 

conformance requirements; 

test area files; 

test coverage; 

test procedure; 

a description of the associated testing tools that shall be used. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

• In the case of a reference to a TC SCP document, a non specific reference implicitly refers to the latest version 
of that document in the same Release as the present document. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are necessary for the application of the present document. 

[1] Sun Microsystems Java Cardf*^ Specification: "Java Card'"^ 2.2.1 Application Programming 

Interface". 

[2] Sun Microsystems Java Card^^ Specification: "Java CardT"^ 2.2.1 Runtime Environment (JCRE) 

Specification". 

[3] Sun Microsystems Java CardT"^ Specification: "Java Card^"^ 2.2.1 Virtual Machine Specification". 

NOTE: SUN Java Card Specifications can be downloaded at http://iava.sun.com/products/iavacard 

[4] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers (Release 6)". 

[5] ETSI TS 102 221: "Smart cards; UICC-Terminal interface; Physical and logical characteristics 

(Releasee)". 
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[6] ETSI TS 102 223: "Smart cards; Card Application Toolkit (CAT) (Release 6)". 

[7] ETSI TS 102 222: "Integrated Circuit Cards (ICC); Administrative commands for 

telecommunications applications (Release 6)". 

[8] ETSI TS 102 226: "Smart Cards; Remote APDU structure for UICC based applications 

(Releasee)". 

[9] ETSI TS 102 241 : "Smart Cards; UICC Application Programming Interface (UICC API) for Java 

Card (TM); (Release 6)". 

[10] ETSI TS 123 040: "Digital cellular telecommunications system (Phase 2+); Universal Mobile 

Telecommunications System (UMTS); Technical realization of Short Message Service (SMS) 
(3GPP TS 23.040)". 

[11] ETSI TS 101 267: "Digital cellular telecommunications system (Phase 2+); Specification of the 

SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM-ME) 
interface (3GPP TS 11.14)". 

[12] ETSI TS 131 213: "Universal Mobile Telecommunications System (UMTS); LTE; Test 

specification for (U)SIM; Application Programming Interface (API) for Java Card'*^ 
(3GPPTS 31.213)". 

2.2 Informative references 

The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 

Not applicable. 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

applet installation parameters: values for applet installation parameters 

Conformance Requirement Reference (CRR): description of the expected card behaviour according to 
TS 102 241 [9] 

expected state: state in which the UICC is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

security parameters: minimum security requirements defined for the applet installation process 

test area: set of Test Cases applicable to a specific part (class method, CAT RE behaviour, etc.) of the TS 102 241 [9] 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test procedure: sequence of actions/commands to perform all the test cases defined in a test area 

test source file: Java file containing methods that will load and install test applet in the card, execute and verify the test 
results, and restore the Default Initial Conditions on the UICC (when possible) 

test toolkit applet: applet designed to test a specific functionality of the UICC API (TS 102 241 [9]) 
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3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AID Application IDentifier 

APDU Application Protocol Data Unit 

API Application Programming Interface 

CAT RE Card Application Toolkit Runtime Environment 

CRE CAT Runtime Environment 

CRR Conformance Requirements Reference 

CRRC Conformance Requirement Reference Context Error 

CRRN Conformance Requirement Reference Normal 

CRRP Conformance Requirement Reference Parameter Error 

JCRE Java Card'^ Runtime Environment 

ME Mobile Equipment 

RFU Reserved for Future Use 

SDK Software Development Kit 



Test environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed, during the test 
procedure. 



4.1 



Applicability 



The test defined in the present document are applicable to cards implementing TS 102 241 [9] unless otherwise stated. 
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4.2 Test environment description 

The general architecture for the test environment is: 



Scope of the Test Suite. 
. Elements of the Test Suite 




NOTE: Figure 4.2 shows the test architecture required to test interoperability at both API and bytcode level. The 
latter is currently not included in the current specification. The diagram is for information. 

Figure 4.2 



4.3 Tests format 
4.3.1 Test area reference 

Each test area is referenced as follows: 
API Testing: 'Api_[package name]_[class name]_[method name]' where: 

• package name: 

uicc.access package: '1'. 
uicc. toolkit package: '2'. 
uicc. system package: '3'. 
uicc. access. iileadininistration: '4'. 

• class/interface name: 

yyy: 3 letters for each class. 
NOTE 1 : See annex A for full classes acronyms list. 
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• method name: 

zzzz[input parameters]. 
NOTE 2: See annex A for full methods name acronyms list. 
CRE: Cat Runtime Environment testing: 'Cre_[Clause name]_[Subclause name]': 

• Clause name: 

xxx: 3 letters for each clause 
NOTE 3: See annex A for full clause acronyms list. 

• Subclause name 

yyyy: : 4 letters for each subclause 
NOTE 4: See annex A for full subclause acronyms list. 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

• Method prototype as listed in TS 102 241 [9]. 

• Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

• Parameter errors: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

• Context errors: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 

4.3.1.2 Test area files 

The files included in the Test Area use the following naming convention: 

• Test Source: Test_[Test Area Reference]. Java. 

• Test Applet: [Test Area Reference]_[Test applet number] .Java. 

• Cap File: [Test Area Reference]. cap. 
The applet numbers start from '1'. 

The test source shall use common interfaces defined in annex D. 

The Cap File format is described in Java Card^"^ Virtual Machine Specification [3]. 

Test files can be run in any order. 

All files from the same test area are located in the same subfolder. 

4.3.1 .3 Test coverage 

The table above each test procedure indicates the correspondence between the Conformance Requirements Reference 
(CRR) and the different test cases. 
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4.3.1 .4 Test procedure 

Each test procedure contains a table to indicate the expected responses from the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Test Case detailed description 


API and/or CAT RE expected behaviour. 


Expected response at APDU level. 



4.4 



Initial conditions 



The Initial Conditions are a set of general prerequisites for the UICC prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

• unless otherwise stated, the file system and the files' content shall fulfil the requirements described in annex B; 

• unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages 
specific to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 



4.5 Package name 



Java packages integrating this Test Suite shall follow this naming convention: 

uicc.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [9] 

uicc. access package. 

uicc.test.system.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [9] 

uicc. system package. 

uicc.test.toolkit.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [9] 
uicc. toolkit package. 

uicc.test.access.fileadniinistration.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 241 [9] uicc. access. fileadministration package. 

uicc.test.catre.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 241 [9] 
CAT Runtime Environment. 

uicc.test.util: for the Test util package defined in this Test Suite. 

where the Test Area Reference is written in lower case. 

EXAMPLE: The package ../uicc.test.access. [Test Area Reference] creates the following directory structure 
../uicc/test/access/[Test Area Ref erence]/ Apt _1 _..._[ l..n].*, where Api_l_..._[l..n].'*' are the 
different test applets Java source files used in [Test Area Reference] . 



4.6 AID Coding 



The AID coding for the Test Packages, Applet classes and Applets shall be as specified in TS 101 220 [4]. In addition, 
the following TAR and Application Provider specific data values are defined for use within the present document: 

AID coding 

Byte 1 [ I Byte 12 | Byte 13 | Byte 14 | Byte 15 



Byte 1 6 



Application Provider specific data 



TAR 



Specified in TS 101 220 [4] 
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TAR Coding (3 bytes/ 24 bits): 



|bi| 


Lb4 1 b5 [ 


|b8 1 b9 1 


ib12|b13| 


|b16|b17l 


|b24| 
























1 


Applet instance number 




Applet class number 










Package number 












RFU 














Test Part Identifier 



Applet instance number, Applet Class number, Package number: 

• For package AID, package number shall start from and class and instance numbers shall be 0. 

• For class AID, package number is the number of the class package, class number shall start from 1 and 
instance shall be 0. 

• For instance AID, package and class number are the number of class and package of which instance belongs, 
and instance number shall start from 1. 

Test part Identifier (bits bl-b4): 

0000 reserved (as TAR= '00.00.00' is reserved for Issuer Security Domain). 

0001 API uicc. access. 

0010 API uicc.toolkit. 

0011 API uicc. system. 

0100 API uicc.access.fileadministration. 

0101 CAT RE. 
1101 ADF2. 

1110 ADFl. 

1111 uicc.util. 
other values are RFU. 

Application Provider specific data (1 byte): 
'00' for Package. 
'Or for Applet class. 
'02' for Applet Instance. 
EXAMPLE: The AID of Package uicc.util is 'AO 00 00 00 09 00 05 FF FFFFFF89 FO 00 00 00'. 



4.7 Test equipment 



These clauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

4.7.1 Test tool 

This test tool shall meet the following requirements: 

• be able to send and receive APDU command to the UICC; 

• the result of the I/O commands must be presented at the application layer; 
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• be able to provide results of the tests; 

• shall send and/or compare all data specified in test file. 

4.7.2 Interfaces and classes use 

The test tool shall use some interfaces and classes, defined in annex D. They define the only allowed methods to write 
the test sources. 

Interfaces and classes are defined as follow: 

UiccAdministrativeCommandsService defines administrative methods from TS 102 222 [7]; 

UiccApplicationManagementService defines methods to load, install, select and delete applications; 

UiccCardManagementService defines methods to manage the card and its files; 

UiccToolkitService defines methods to manage toolkit commands; 

APDUResponse defines method to retrieve and check status words and data received from the card; 

UiccAPITestCardService defines the static method to get a reference of the class implementing all interfaces; 

UiccTestModel is an abstract class which shall be extended by every test source class; it defines the entry point 
run() method of the test script. 

4.7.3 Util package 

Annex D includes Java source code of TestTooUcitApplet abstract class of the uicc.util package. Each test applet shall 
extend this abstract class in order to retrieve test results when selecting it. 

4.7.4 Java Software Development kit version 

Java software development kit (SDK) version supported by JavaCard 2.2.1 specifications ([1], [2], [3]) is 1.4.1. 
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Test plan 



5.1 Package uicc. access 
5.1.1 Interface FileView 
5.1.1.1 Method activateFile 

Test Area Reference: Api_l_Fvw_Actf 

5.1.1.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void activateFile { ) 

throws UICCException 

5.1.1.1.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be activated, as defined in TS 102 222 [7]. 



5.1.1.1.1.2 

No requirements. 

5.1.1.1.1.3 



Parameter errors 



Context errors 



• CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.1.1.1.2 Test area files 

Test Source: Test_Api_l_Fvw_Actf.java. 

Test Applet: Api_l_Fvw_Actf_l.java. 

Cap File: api_l_fvw_actf.cap. 

5.1.1.1.3 Test coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 


C2 


4 


C3 


Not testable 
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5.1.1.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- Select DFtest f id=llll 

2- Call activateFileO 


2- A UlCCException 
NO_EF_SELECTED is 
thrown 




2 


Activate deactivated File 

0- Select Root directory 

1- Select EFnicc f id=2FFF 

2- ReadBinary EFnicc 

3- Deactivate EFnicc 

4- ReadBinary EFnicc 

5 -ActivateFile EFnicc 
6- ReadBinary EFmcc 


2- No Exception shall be 

thrown 

4- 

UlCCException.REF DATA 

INVALIDATED is thrown 

6- No Exception shall be 

thrown 




3 


Activate activated File 

ActiveFile EFmcc 


No Exception shall be thrown 




4 


Access condition not fulfilled 

1- Select DFtest fid=llll 

2- Select EFLma fid=6F15 

3- ActivateFile EFLsna 


3- A UlCCException 
SECURITY STATUS NOT 
SATISFIED is thrown 





5.1.1.2 Method deactivateFile 

Test Area Reference: Api_l_Fvw_Dacf. 

5.1 .1 .2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deactivateFile { ) 

throws UlCCException 

5.1.1.2.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be deactivated, as defined in TS 102 222 [7]. 

5.1.1.2.1.2 Parameter errors 
No requirements. 

5.1.1.2.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UlCCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UlCCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CCRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UlCCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.1.1.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.2.3 



Test area files 

Test_Api_l_Fvw_Dacf.java. 
Api_l_Fvw_Dacf_l .Java. 
api_ 1 _fv w_dacf . cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 


C2 


4 


C3 


Not testable 



5.1.1.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- select DFtest f id=llll 

2- call deactivateFile {) 


2- An UlCCException 
NO_EF_SELECTED is 
thrown 




2 


Deactivate activated File 

0- Select root directory 

1- Select EFnicc f id=2FFF 

2- ReadBinary EFmcc 

3- Deactivate EFmcc 

4- ReadBinary EFmcc 


2- No Exception shall be 

thrown 

4- 

UlCCException.REF DATA 

INVALIDATED is thrown 




3 


Deactivate deactivated File 

1- deactivateFile EFmcc 

2- activateFile EFmcc 


1- No Exception shall be 
thrown 




4 


Access condition not fulfilled 

1- select DFtest fid=llll 

2- select EFlma fid=6F15 

3- deactivateFile EFuma 


3- An UlCCException 
SECURITY STATUS NOT 
SATISFIED is thrown 
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5.1 .1 .3 Method increase 

Test Area Reference: Api_l_Fvw_Incr. 

5.1 .1 .3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short increase {byte [] incr, 

short incrOffset, 
short incrLength, 
byte [] resp, 
short respOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 

5.1.1.3.1.1 Normal execution 

• CRRNl: This method increases the current cyclic EF record. 

• CRRN2: The response buffer will only contain the value of the increased record. 

5.1.1.3.1.2 Parameter errors 

• CRRPl : If the array incr is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP3: If incrOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If incrLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If respOffset is negative, an instance of ArraylndexOutOfBoundsExceptoin shall be thrown. 

• CRRP6: If incrOffset plus incrLength, is greater than the length of array incr, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no increase is performed. 

• CRRP7: If respOffset is greater than the length of array resp, an instance of 
ArraylndexOutOfboundsException shall be thrown. 

• CRRP8: If the result of the addition is greater than the maximum value of the record (represented by all bytes 
set to 'FF'), an instance of UICCException shall be thrown. The reason code shall be 
UICCException.MAX_VALUE_REACHED. 

• CRRP9: If incrLength is greater than 127, and exception shall be thrown. 

5.1.1.3.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC4: If increase not allowed as indicated by the File descriptor byte of the File Descriptor (TS 102.221 [5] 
Response for an EF), or the file is not a cyclic one, an instance of the UICCException shall be thrown. The 
reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

• CRRC5: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 
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• CRRC6: If the currently selected EF is invalidated, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.REF_DATA_INVALIDATED. 

• CRRC7: If the currently selected cyclic EF has no record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 



5.1.1.3.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_Incr.java. 
Api_ 1 _Fvw_Incr_ 1 .j ava. 
api_ 1 _fvw_incr.cap . 



5.1.1.3.3 



Test coverage 



5.1.1.3.4 



CRR number 


Test case number 


N1 


1,2,3, 16 


N2 


2,3, 16 


P1 


4 


P2 


9 


P3 


6 


P4 


5 


P5 


10 


P6 


7 


P7 


11 


P8 


8 


P9 


16 


C1 


1 


C2 


Not testable 


C3 


Not testable 


C4 


12 


C5 


13 


C6 


14 


C7 


15 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFtest f id=llll 

2- byte[] incr = new byte [4] 
byte[] resp = new byte [4] 
incrOffset = 
incrLength = 2 
respOffset = 

increase { ) 


2- An 

UICCException. NO_EF_SEL 

ECTED should be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


increase , verify response 

1- select EFcARu, fid=6F09 

set the record pointer with 

readRecord { ) in PREVIOUS mode 

2-//Set both record to 00 00 00 

mode = REC_ACC_iyiODE_PREVIOUS 

data[] = {0x00,0x00,0x00} 

recOffset = 

dataOffset = 

dataLength = 3 

updateRecord { ) //update Record 1 

updateRecord { ) //update Record 2 

3- incr[] = {0x00,0x00,0x01} 

incrOffset = 

incrLength = 3 

resp. length = 4 

respOffset = 

ret = 3 

increase {) 


3- resp[] = 
{0x00,0x00,0x01,0x00} 




3 


increase, verify file 

1- incr [] ={OxOO, 0x00, 0x00, 0x02} 
incrOffset = 1 

incrLength = 3 
resp. length = 4 
respOffset = 1 
increase { ) 

2- resp[] = {0x00,0x00,0x00,0x00} 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

resp. length =4 

respOffset = 

respLength = 3 

readRecord { ) 


1 - resp[] = 
{0x00,0x00,0x00,0x03} 

2- resp[] = 
{0x00,0x00,0x03,0x00} 




4 


incr[] is null 

incr[] = null 
incrOffset = 
incrLength = 1 
resp. length = 4 
respOffset = 
increase { ) 


Shall throw 

java.lang.NullPolnterExceptio 

n. 




5 


incrLength< 

incr.length = 4 
incrOffset = 
incrLength = -1 
resp. length = 4 
respOffset = 
increase { ) 


Shall throw 

java.lang. 

Array IndexOutOfBoundsExc 

eption. 




6 


incrOffset < 

incr.length = 4 
incrOffset = -1 
incrLength = 1 
resp. length = 4 
respOffset = 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

eption. 




7 


IncrOffset + incrLength > incr.length 

incr.length = 4 

incrOffset = 1 

incLength = 4resp. length = 4 

respOffset = 

increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

eption. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Reach Maximum Value 

1- incr [0:3] = OxFF 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 
increase { ) 

2- //Set both record to FF FF FF 
mode = REC_ACC_MODE_PREVIOUS 
data[] = {OxFF, OxFF, OxFF } 
recOffset = 

dataOffset = 

dataLength = 3 

updateRecord { ) //update Record 1 

updateRecord { ) //update Record 2 

3- incr[] = {0x00,0x00,0x01} 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 

increase { ) 


1- Shall throw 

uicc.access.UICCException 
with reason code 
MAX_VALUE_REACHED. 

2- Shall throw 

uicc.access.UICCException 
with reason code 
MAX_VALUE_REACHED. 




9 


resp[] is null 

incr. length = 4 
incrOffset = 
incrLength = 1 
resp[] = null 
respOffset = 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




10 


respOffset < 

incr. length = 4 
incrOffset = 
incrLength = 1 
resp.length = 4 
respOffset = -1 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




11 


respOffset + recordLength > resp.length 

incr. length = 4 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 2 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




12 


EF is not Cyclic 

1- select EFtaru fid= 6F03 

2- incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase { ) 

3 - select EFlaru, fid=6F0C 

4 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase { ) 


2 - Shall throw 
uicc.access.UICCException 
with reason code 
COMMAND INCOMPATIBL 

E. 

4 - Shall throw 
uicc.access.UICCException 
with reason code 
COMMAND INCOMPATIBL 

E. 




13 


Access condition not fulfilled 

1- select EFcNic, fid=6F06 

2- incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase { ) 


2 - Shall throw 
uicc.access.UICCException 
with reason code 
SECURITY STATUS NOT 
SATISFIED. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


EF is invalidated 

select EFcAEu, fid=6F09 

2 - invalidate {) 

3 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp. length = 3 
respOffset = 
increase { ) 

4 - rehabilitate {) 

5- Restore initial content of EFcaru 


3 - Shall throw 
uicc.access.UICCException 
with reason code 
REF_DATA_INVALIDATED 




15 


Record not found 

1- Create an EF Cyclic with no record 
in folder DFtest, fid=0x2C00 

2- select EF Cyclic with no record, 
fid=0x2C00 

3- incr.length= 3 
incrOffset = 
incrLength = 3 
resp. length = 3 
respOffset = 
increase { ) 

4- Delete Cyclic EF with no records. 


3- Shall throw 

uicc.access.UICCException 
with reason code 
RECORD_NOT_FOUND 




16 


incrLength out of range 

1- Create an EF Cyclic with 1 record of 
OxFD length in folder DFtest, fid=0x2CFD 

2- Select EF Cyclic, fid=0x2CFD 

3- Set record to following value 

rec [0.. 125] = 0; rec [126 .. 253] = OxFF 
with an update record. 

4- incr . length=128 
incrOffset = 1 
incrLength =12 7 
resp. length = 128 
respOffset = 

Incr[] initialized to = {OxOO,... 
,0x00, 0x01} 
respOffset = 
ret = OxFD 
increase { ) 

5- incr . length=128 
incrOffset = 
incrLength = 128 
resp. length = 128 
respOffset = 

Incr[] initialized to 
respOffset = 
increase { ) 

6- Delete EF Cyclic with fid=0x2CFD. 


4-resp[0..125] = 
{0x00,..., 0x00,0x01} and 
resp[126..254] = 
{0x00,..., 0x00} 

5- Shall throw an exception 





5.1 .1 .4 Method readBinary 

Test Area Reference: Api_l_Fvw_Redb. 

5.1 .1 .4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short readBinary {short fileOffset, 

byte [] resp, 
short respOffset, 
short respLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 
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5.1.1.4.1.1 Normal execution 

• CRRN 1 : . Reads the data bytes of the current transparent EF, as defined inTS 1 02 221 [5]. 

• CRRN2: The sum of respOffset plus respLength is returned, and the data bytes of the currently selected 
transparent file are returned in resp. 

5.1.1.4.1.2 Parameter errors 

• CRRPl : If fileOffset is negative, an instance of UICCException.OUT_OF_FlLE_BOUND ARIES shall be 
thrown. 

• CRRP2: If respOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If respLength is negative, an instace of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP5: If respOffset plus respLength is greater than the length of the array resp. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no read is performed. 

• CRRP6: If fileOffset plus respLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UlCCException.OUT_OF_FlLE_BOUND ARIES. 

5.1.1.4.1.3 Context errors 

• CRRCl: If the method call causes an error to occur that is not expected and thus not handled, an instace of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.COMMANDJNCOMPATlBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for the reading 
of an deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DAT_INVALIDATED. 

• CRRC5:If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

5.1.1.4.2 Test area files 

Test Source: Test_Api_l_Fvw_Redb.java. 
Test Applet: Api_l_Fvw_Redb_l.java. 

Cap File: api_l_fvw_redb.cap. 
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5.1.1.4.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


1,2 


P1 


3 


P2 


6 


P3 


7 


P4 


5 


P5 


8 


P6 


4 


C1 


Not testable 


C2 


9 


C3 


10 


C4 


11 


C5 


12 



5.1.1.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Read from EFtaru 

1- select DFtest, fid=llll 
select EFtaru, fid=6F03 

2- fileOffset = 
resp.length = 26 
resp [0:259] = 0x55 
respOffset = 10 
respLength = 250 
readBinary { ) 


2 - shall return 20. 

resp shall contain the contents of 

EFtaru Starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FFFFFFFFFFFF.... FF> 




2 


Read from EFtaru 

fileOffset = 5 
resp.length = 26 
resp [0:259] = 0x55 
respOffset = 10 
respLength = 5 
readBinary { ) 


shall return 15 

resp shall contain the last 5 bytes of 

EFtaru Starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FFFFFFFFFF55 55....55> 




3 


FileOffset is negative 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




4 


FileOffset + respLength > EF length 

fileOffset = 259 
respOffset = 
respLength = 2 
readBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




5 


resp[] is null 

fileOffset = 
resp = null 
respOffset = 
respLength = 10 
readBinary { ) 


Shall throw 
java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


RespOffset + respLength > resp.length 

fileOffset = 
resp.length =20 
respOffset = 10 
respLength = 11 
readBinary {) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


EF is not Transparent 

1- select EFlaeu, fid=6F0C 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary { ) 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 




10 


Access condition not fulfilled 

1- select EFthac, fid=6F0E 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary { ) 


2- Shall throw uicc.access.UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 




11 


EF is deactivated 

1 - select EFtaru, fid=6F03 

2 - deactivateFile {) 

3 - readBinary {) 

4 - activateFile {) ) 


3 - Shall throw 

uicc.access.UICCException with 
reason code 
REF_DATA_INVALIDATED. 




12 


No EF selected 

1- select DFtest f id=llll 
2 readBinary {) 


2 - Shall throw 

uicc.access.UICCException with 
reason code NO EF SELECTED. 





5.1 .1 .5 Method read Record 

Test Area Reference: Api_l_Fvw_Redr. 

5.1 .1 .5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short readRecord {short recNumber, 

byte mode, 
short recOffset, 
byte [] resp, 
short respOffset, 
short respLength) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
UICCException 



5.1.1.5.1.1 



Normal execution 



CRRNl: Reads a record or a part of record of a current linear fixed or cyclic EF into byte array resp and the 
sum of respOffset plus respLength is returned. 

CRRN2: If the access mode is REC_ACC_MODE_CURRENT the current record will be read and the current 
record pointer shall not be changed. 

CRRN3: If the access mode is REC_ACC_MODE_ ABSOLUTE the record addressed by recNumber will be 
read and the current record pointer shall not be changed. 

CRRN4: If the access mode is REC_ACC_MODE_NEXT the next record relative to the current selected 
record will be selected and read. The record pointer will be incremented. 

CRRN5: If the access mode is REC_ACC_MODE_NEXT and no current record is selected, the first record 
will be selected and read. The record pointer will be incremented. 

CRRN6: If the access mode is REC_ACC_MODE NEXT and the current record pointer, of a cyclic EF, is set 
to the last record, the record pointer is set to the first record and the record is read. 
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• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and read. 

• CRRN8: If the access mode is REC_ACC_MODE PREVIOUS and no current record is selected, the last 
record will be selected and read. 

• CRRN9:If the access mode is REC_ACC_MODE_PREVIOUS and the current record pointer of a cycUc EF is 
set to the first record, the record pointer is set to the last record in this EF and this record shall be read. 

• CRRNIO: The current record pointer of any other applet shall not be changed. 

5.1.1.5.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE_CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException.RECORD_NOT_FOUND. 

• CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus respLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICC Exception.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
UICCException shall be thrown. The reason code shall be UICC Exception.INVALID_MODE. 

• CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If respOffset plus respLength is greater than the length of the array resp. length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

5.1.1.5.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 



• 



• 



CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 
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CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.5.3 



Test area files 

Test_Api_ 1 _Fvw_Redr.j ava. 
Api_ 1 _Fvw_Redr_ 1 .j ava. 
api_l_fvw_redr.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3,4, 5,6, 8,9, 10, 11,12,13 


N2 


3,9 


N3 


2,8 


N4 


4,5, 10, 11 


N5 


4, 11 


N6 


11 


N7 


6, 7, 12, 13 


N8 


6, 13 


N9 


12 


N10 




P1 


14 


P2 


15 


P3 


5 


P4 


7 


P5 


16 


P6 


17 


P7 


18 


P8 


19 


P9 


20 


P10 


21 


P11 


22 


C1 


1 


C2 


23 


C3 


24 


C4 


25 


C5 


Not testable 



5.1.1.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFtest, f id=llll 








2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] resp = new byte [20] 


2-Shall throw 

uicc.access.UICCException with reason 
code NO_EF_SELECTED. 






respOffset = 








respLength = 10 








readRecord { ) 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute from Linear Fixed EF 

1 - select EFlaru, fid=6F0c 
// Record pointer not set. 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 


2 - resp shall be: 
resp={OxAA,OxAA,OxAA,OxAA} 

3- resp shall be: 
Resp={0x55,0x55,0x55,0x55} 




3 


Read Current from Linear Fixed EF 

//record pointer shall not be changed 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 


resp shall be: 
resp={0x55,0x55,0x55,0x55} 




4 


Read Next from Linear Fixed EF 

1- select EFlaru, fid=SFOc 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

2- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 


1- resp shall be: 
resp={0x55, 0x55,0x55,0x55} 

2- resp shall be: 
resp={OxAA,OxAA,OxAA,OxAA} 




5 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 


Shall throw uicc. access. UICC Exception 
with reason code 
RECORD_NOT_FOUND. 




6 


Read Previous from Linear Fixed EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

2- select EFlaru, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 


1- resp shall be: 
resp={0x55, 0x55, 0x55, 0x55} 

2- resp shall be: 
resp={0xAA,0xAA,0xAA,0xAA} 




7 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 


Shall throw uicc. access. UlCCException 
with reason code RECORD 
_NOT_FOUND. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Read Absolute from Cyclic EF 

1 select EFcaeu, fid = 6F09 

2- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 

3- recNumber = 1 
readRecord { ) 


2 - resp shall be: 
resp={OxAA,OxAA,OxAA} 

3 - resp shall be: 
resp={OxAA,OxAA,OxAA} 




9 


Read Current from Cyclic EF 

//record pointer shall not be changed 

//from testcase before 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 3 

readRecord { ) 


1- resp shall be: 
resp={OxAA,OxAA,OxAA} 




10 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 


resp shall be: 
resp={OxAA,OxAA,OxAA} 




11 


Read Next from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 

2- select EFcaeu, fid = 6F09 
//no rec selected 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 


1- resp shall be: 
resp={0x55,0x55,0x55} 

2- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




12 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 3 

readRecord { ) 


1- resp shall be: 
resp={OxAA,OxAA,OxAA} 




13 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 

2- select EFcaeu, fid = 6F09 
// no rec selected 
recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 


1- resp shall be: 
resp={0x55,0x55,0x55} 

2- resp shall be: 
resp={OxAA,OxAA,OxAA} 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Read Absolute from Linear Fixed EF beyond 
Records 

1- select EFlaru, fid=6F0C 

2- recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

3- recNumber = 3 
readRecord { ) 


2- Shall throw an 

uicc.access.UICCException with reason 
code 
UICCException.RECORD_NOT_FOUND. 

3- Shall throw an 

uicc.access.UICCException with reason 
code 

UlCCException. RECORD NOT FOUND. 




15 


No current record in linear fixed EF, read 
current 

1- select EFlaru, fid=6F0C // No current 
record 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE_CURRENT 
recOffset = 

respOffset = 
respLength = 4 
readRecord { ) 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 




16 


recOffset < 

1- select EFlaru, fid=SFOC 

2- recNumber =1 // rec 1 
mode = REC_ACC_MODE_ABSOLUTE 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord { ) 


2 - Shall throw uicc.access.UICCException 
with reason code 
OUT_OF_RECORD_BOUNDARIES. 




17 


recOffset + respLength > Record Length 

1- select EFlaru, fid=6F0C 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 2 
respOffset = 
respLength = 4 
readRecord { ) 


2 - Shall throw 

sim. access. SIIVIViewException with reason 

code OUT_OF_RECORD_BOUNDARIES. 




18 


Reading with invalid mode 

1- select EFlaru, fid=6F0C 

2- recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

3- mode = 5 
readRecord { ) 


2 - Shall throw uicc.access.UICCException 
with reason code INVALID_MODE 

3 - Shall throw uicc.access. 
UlCCException with reason code 
INVALID MODE. 




19 


resp is null 

resp[] = null 

mode = REC_ACC_MODE_CURRENT 

respOffset = 

respLength = 10 

readRecord { ) 


Shall throw 
java.lang.NullPointerException. 




20 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord {) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExcepti 

on. 




21 


respLength < 

respOffset = 
respLength = -1 
readRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




22 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord {) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




23 


EF is neither Cyclic nor Linear Fixed 

1- select EFtnu, fid=GF02 

2- respOffset = 
respLength = 4 
readRecord { ) 


2 - Shall throw uicc.access.UICCException 
with reason code 
COMMAND INCOMPATIBLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


24 


Access condition not fulfilled 

1- select EFcNE, fid=eF04 
2 - respLength = 3 
readRecord { ) 


2 - Shall throw uicc.access.UICCException 

with reason code 

SECURITY STATUS NOT SATISFIED. 




25 


EF is deactivated 

1 - select EFcKD, fid=6F05 
deactivateFile { ) 

2 - readRecordO 

3 - activateFile 


2 - Shall throw uicc.access.UICC 
Exception with reason code 
REF DATA INVALIDATED 





5.1.1.6 Method search Record 

Test Area Reference: Api_l_Fvw_Sear. 



5.1.1.6.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short searchRecord {byte mode, 

short recordNum, 
short searchlndication, 
byte[] patt, 
short pattOffset, 
short pattLength, 
short [] response, 
short respOffset, 
short respLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 

5.1.1.6.1.1 Normal execution 

• CRRNl: Search a given pattern in byte array patt[] of a current linear fixed or cyclic EF. 

• CRRN2: If the pattern is found, the number of each record is stored in byte array response [] and the total 
number of updated bytes in the array response [] buffer is returned. 

• CRRN3: If the value of respLength is greater than the number of records found, the whole response is copied 
into the response buffer and the number of elements copied is returned by the method. 

• CRRN4: If the value of respLength is smaller than the number of found patterns, the first record numbers are 
copied into the response array and the value of respLength is returned. 

• CRRN5: If mode is SIMPLE_SEARCH_START_FORWARD, the search starts at the given record number 
forward towards the end of the file. 

• CRRN6: If mode is SIMPLE_SEARCH _START_BACKWARD, the search starts at a given record number 
backward towards to the beginning of the file. 

• CRRN7: If mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS is set in searchlndication, the search 
is backward starting from previous record towards to the beginning of the file. 

• CRRN8 : If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS_GR is set in searchlndication, the 
search is backward starting at a given record from previous record towards to the beginning of the file. 

• CRRN9: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_FORWARD_FROM_NEXT is set in searchlndication, the search is 
forward starting at the next record towards the end of the file. 
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• CRRN 1 0: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_FORWARD_FROM_NEXT_GR is set in searchlndication, the search is forward 
starting at a given record number towards to the end of the file. 

• CRRN 1 1 : If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is not set, the search starts in the record from the offset (absolute position) given in the less 
significant byte of searchlndication. 

• CRRN12: If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is set, the search starts in the record after the first occurrence of the value contained in the less 
significant byte of searchlndication. 

• CRRN 13: If pattern given in patt[] is not found, the method returns 0. 

• CRRN 14: If one or more matches are found the record pointer shall be set to the first record where the search 
pattern was found. 

5.1.1.6.1.2 Parameter errors 

• CRRPl : If mode is not 4, 5 or 6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE. 

• CRRP2: If the pattern array patt is null, an instance of java.lang.NullPointerException shall be thrown. 

• CRRP3: If the response array response is null, an instance of java.lang.NullPointerExceptino shall be thrown. 

• CRRP4: If parameter pattOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP5: If parameter pattLength is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP6: If parameter respOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP7: If parameter respLength negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP8: If parameter pattOffset plus pattLength are greater than the length of array patt, an instance of 
java.lang.ArraylndexOutOfBoundsException shall be thrown. 

• CRRP9: If parameter respOffset plus respLength are greater than the length of array response a 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If parameter recordNum is negative, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.RECORD_NOT_FOUND. 

• CRRPll: If parameter recordNum is greather than, the total number of records from the currently selected EF, 
an instance of UICCException shall be thrown. The reason code shall be 
UICCException.RECORD_NOT_FOUND. 

• CRRPl 2 If pattLength is greater than record size of the currently selected EF an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 

5.1.1.6.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 



• 



CRRC2: If the currently selected EF is not linear fixed or cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 
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CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for reading a 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.6.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_Sear.java. 
Api_l_Fvw_Sear_l .Java. 
api_l_fvw_sear.cap. 



5.1.1.6.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 33, 34, 35, 36, 37 


N2 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 11 , 28, 29, 30, 31 , 32, 33, 34, 35, 36, 37 


N3 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 33, 34, 35, 36, 37 


N4 


12 


N5 


2,28 


N6 


3,29 


N7 


6, 7, 34, 35 


N8 


8, 9, 36, 37 


N9 


10, 11,30,31 


N10 


12, 13,32, 33 


N11 


6,8, 10, 12,30,32,34,36 


N12 


7,9,11,13,31,33,35,37 


N13 


2,3,5,7,9, 11,28,31 


N14 


6,7, 10, 11,30,31,34,35 


P1 


13 


P2 


14 


P3 


15 


P4 


16 


P5 


17 


P6 


18 


P7 


19 


P8 


20 


P9 


21 


P10 


22 


P11 


23 


P12 


24 


C1 


1 


C2 


25 


C3 


26 


C4 


27 


C5 


Not testable 
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5.1.1.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFtest, fid=llll 








2- searchRecord { ) 


2-shall throw uicc. access. UICC 
Exception with reason code 
NO EF SELECTED. 




2 


Fixed linear EF, 
Simple mode search forward 

1- select EFlsea, fid=6FlA 








2- mode = SIMPLE_SEARCH_START_FORWARD 

recordNum = 1 

patt [] ={OxlO, 0x03, 0x04} 


2- no exception shall be thrown 
Shall return 0. 






pattOffset = 


response shall be: 






pattLength = 1 


response={0, 0,0,0} 






response [] = {0,0, 0,0} 








respOffset = 








respLength = 4 








searchRecord { ) 








3- Simple mode search forward 








mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 2 








patt [] ={0x10, 0x03, 0x04} 


3- Shall return 2. 






pattOffset = 1 


response shall be: 






pattLength = 2 


response={0,2,4,0} 






resp. length = 4 








respOffset = 1 








respLength = 3 








searchRecord { ) 








4- Simple mode search forward 








mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 








patt [] ={0x10, 0x03, 0x04} 








pattOffset = 1 








pattLength = 2 


4- Shall return 2. 






resp. length = 4 
respOffset = 1 


response shall be: 






respLength = 3 


response={0, 2,4,0} 






searchRecord { ) 






3 


Simple mode, search backward 








1- mode = SIMPLE_SEARCH_START_BACKWARD 


1- shall return 0. 






recordNum = 1 

patt [] ={0x08, OxOA, OxOB} 


response shall be: 

r f^ ^^ ^^ y^ 1 






pattOffset = 


response={0, 0,0,0} 






pattLength = 3 








response [] = {0,0,0,0} 








respOffset = 2 








respLength = 2 








searchRecord { ) 








2 -mode = SIMPLE_SEARCH_START_BACKWARD 








recordNum = 6 








patt [] ={0x08, 0x09, OxOA, OxOB } 








pattOffset = 1 


2- shall return 3. 






pattLength = 2 


response shall be: 






response [] = {0,0,0,0} 


response={0,4,3,1} 






respOffset = 1 








respLength = 3 








searchRecord { ) 








3 -mode = SIMPLE_SEARCH_START_BACKWARD 








recordNum = 








patt []={0x08, 0x09, OxOA, OxOB } 








pattOffset = 1 








pattLength = 2 








response [] = {0,0,0,0} 


3- shall return 3. 






respOffset = 1 


response shall be: 






respLength = 3 
searchRecord { ) 


response={0,4,3,1} 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Enhanced Mode, search backward from 

previous record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+ 0x0009 

recordNum = 

patt [] ={0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+0x0000 

recordNum = 

patt [] ={OxOC, OxOD, OxOE, OxOF, 0x01, 0x02} 

pattOffset = 

pattLength = 5 

response [] = {0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 


1- shall return 1, 
response shall be: 
resp={3,0,0,0} 

2- shall return 1 
response shall be: 
response={0,0,2,0} 




5 


Enhanced Mode, search backward from 
previous record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+ 0x0810 

recordNum = 

patt []={0x01, 0x02, 0x0 3, 0x04} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 

2- perform 3 readRecord { ) in next mode 
to set current pointer to pointer 5 

3- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+0x080E 

recordNum = 

patt []={0x01, 0x02, 0x0 3, 0x04} 

pattOffset = 3 

pattLength = 1 

response [] = {0,0, 0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

3- shall return 2 
response shall be: 
response={4,2,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Enhanced IVIode, search backward from 

previous given record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0000 

recordNum = 1 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH INDICATION BACKWARD FROM PREVIOUS 

_GR + 0x0 04 

recordNum = 6 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 


1- shall return 1, 
response shall be: 
resp={1 ,0,0,0} 

2- shall return 4 
response shall be: 
response={5,4,3,2} 




7 


Enhanced Mode, search backward from 

previous given record, start from a value in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0 SOD 

recordNum = 1 
patt [] ={OxOE, OxOE, OxOE} 
pattOffset = 1 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0800 

recordNum = 6 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0, 0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 1, 
response shall be: 
resp={1 ,0,0,0} 

2- shall return 
response shall be: 
response={0, 0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Enhanced Mode, search forward from next 
record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0003 

recordNum = 
patt [] ={OxOO, OxOA, OxOB} 
pattOffset = 1 
pattLength = 2 
response [] = {0,0,o} 
respOffset = 2 
respLength = 2 
searchRecord { ) 

2- Perform readRecord { ) in previous mode 

3- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0003 

recordNum = 
patt [] ={0x00, OxOA, OxOB} 
pattOffset = 1 
pattLength = 2 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 2 
response shall be: 
resp={0,0,3,4} 

3- shall return 1 
response shall be: 
response={4, 0,0,0} 




9 


Enhanced Mode, search forward from next 
record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH INDICATION FORWARD_FROM_NEXT + 

0x0804 

recordNum = 

patt [] ={0x01,0x02, 0x0 3} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0, 0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0801 

recordNum = 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 2 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

2- shall return 2 
response shall be: 
response={5,6,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Enhanced Mode, search forward from next 
given record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
0x0007 

recordNum = 1 
patt [] ={0x01,0x02, 0x0 3} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 1 
respLength = 3 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOOOC 

recordNum = 3 
patt []={0x03, 0x02, 0x01 } 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 3, 
response shall be: 
resp={0,3,4,5} 

2- shall return 1 
response shall be: 
response={6, 0,0,0} 




11 


Enhanced Mode, search forward from next 
given record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOSOD 

recordNum = 5 
patt [] ={0x01, 0x02,0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOSOC 

recordNum = 5 
patt [] ={0x01, 0x02,0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 0, 
response shall be: 
resp={0, 0,0,0} 

2- shall return 1 
response shall be: 
response={5, 0,0,0} 




12 


Simple mode, total number of found patterns 
exceed response[] 

1- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 4 
response shall be: 
response={1, 2,3,4} 

2- shall return 4 
response shall be: 
response={1,2,3,4,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Invalid mode 

mode = 0x14 {simple search forward with 

SFI) 

searchIndication= 

recordNum = 2 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 


shall throw an uicc. access. UICC 
Exception with reason code 
INVALID_MODE. 




14 


Pattern array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []= null 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 


shall throw an 
java.lang.NullPointerException. 




15 


Response array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = 1 

response [] = null 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an instance of 
java.lang.NullPointerException. 




16 


pattOffset<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = -1 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord ( ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




17 


pattLength<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = -1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




18 


respOffset <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = -1 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


respLength <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = -1 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




20 


PattOffset + pattLength > patt[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 2 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 1 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




21 


RespOffset + respLength > response[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 3 

respLength = 3 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




22 


recordNum < 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = -1 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an uicc. access. UICC 
Exception with reason code 
RECORD_NOT_FOUND 




23 


RecordNum > total number of file records 

1- mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 7 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


1- shall throw an uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND 
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Id 


Description 


API Expectation 


APDU Expectation 


24 


pattlength > record length 

1- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 3 

patt [16] ={0x55, 0x5 5,..., 0x5 5} 
pattOffset = 
pattLength = 16 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH INDICATION FORWARD FROM NEXT GR + 

OxOOOE 

recordNum = 3 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


1- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 

2- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 




25 


Wrong file structure 

1- select EFtdac, fid=6F0F 

2- searchRecord { ) 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

COMMAND INCOMPATIBLE 




26 


Security status not satisfied 

1- select EFlnr, fid=6F0A 

2- searchRecord { ) 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFI 

ED 




27 


File deactivated 

1- select EFlseu, fid=6F10 

2- deactivateFile EFlseu 

3- searchRecord { ) 

4- activateFile { ) 


3- shall throw an 

uicc. access. UlCCException with 

reason code DATA INVALIDATED 
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Id 


Description 


API Expectation 


APDU Expectation 


28 


Cyclic EF, Simple mode search forward 

1- select EFcsEA, fid=6FlB 








2- mode = SIMPLE_SEARCH_START_FORWARD 

recordNum = 1 

patt []={OxlO, 0x0 3, 0x04} 

pattOffset = 


2- shall return 
response shall be: 
response={0,0,0,0,0} 






pattLength = 1 








response [] = {0,0,0,0,0} 








respOffset = 








respLength = 5 








searchRecord { ) 








3- mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 2 








patt [] ={OxlO, 0x03, 0x04} 
pattOffset = 1 


3- Shall either 






pattLength = 2 


return 3 and response shall be: 






response [] = {0,0,0,0,0} 
respOffset = 2 


response={0,0,2,4,1} 
or shall 






respLength = 3 
searchRecord { ) 
4- updateRecord { ) in previous mode with 


return 2 and response shall be: 
response={0,0,2,4,0} 






value 








{0x03, 0x02, 0x01, 0x03, 0x02, 0x01, 0x03, 0x02 








, 0x01, 0x03, 0x02, 0x01, 0x03, 0x02, OxOl} 








{new record 1 is set to previous record 

6) 

5- mode = SIMPLE_SEARCH_START_FORWARD 














recordNum = 2 








patt [] ={OxlO, 0x03, 0x04} 








pattOffset = 1 








pattLength = 2 

response [] = {0,0,0,0,0} 


5- Shall return 3. 






respOffset = 2 


response shall be: 






respLength = 3 
searchRecord { ) 


response={0, 0,2,3,5} 




29 


Cyclic EF, Simple mode search backward 








mode = SIMPLE_SEARCH_START_BACKWARD 


Shall either 






recordNum = 3 

patt [] ={0x10,0x03, 0x04} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 


return 3 and response shall be: 

response={0,3,2,5,0} 

or shall 

return 2 and response shall be: 






respOffset = 1 


response={0,3,2,0,0} 






respLength = 4 








searchRecord { ) 






30 


Cyclic EF, Enhanced mode, search forward 

from next record, start from an offset in 

record 








mode = ENHANCED_MODE 
searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 
T + 0x0009 


shall return 3 
response shall be: 
response={0,0,4,5,6} 






recordNum = 








patt [] ={0x01, 0x02, 0x03} 








pattOffset = 








pattLength = 3 








response [] = {0,0,0,0,0} 








respOffset = 2 








respLength = 3 








searchRecord { ) 
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Id 
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API Expectation 


APDU Expectation 


31 


Cyclic EF, Enhanced mode, search forward 

from next record, start from a value in 

record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T + 0x0810 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 3 

searchRecord { ) 


shall return 
response shall be: 
response={0,0,0,0,0} 




32 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from an offset 

in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T_GR + 0x00 05 

recordNum = 3 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall either 

return 5 and response shall be: 

response={3,4,5,6,1} 

or shall 

return 4 and response shall be: 

response={3,4,5,6,0} 




33 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from a value in 

record 

1- mode = ENHANCED_MODE 
searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 
T_GR + 0x08 05 

recordNum = 6 
patt [] ={0x0E, OxOF, 0x0 0} 
pattOffset = 
pattLength = 2 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 

2- Restore EF initial state (record 1 
shall be assigned to the record that 
content is 

{0x01,0x02, 0x0 3, 0x04, 0x0 5, 0x0 6, 0x0 7, 0x0 8 
, 0x09, OxOA, OxOB, OxOC, OxOD, OxE, OxOF} ) 
using 5 updateRecord { ) in previous mode 


1- shall either 

return 2 and response shall be: 

response={2,4,0,0,0} 

or shall 

return and response shall be: 

response={0,0,0,0,0} 




34 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from 

an offset in record 

1- Set current record pointer to record 
6 using 5 readRecordO in next mode 

2- mode = ENHANCED_MODE 
searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 
EVIOUS + 0x0003 

recordNum = 
patt [] ={0x02, 0x01,0x0 0} 
pattOffset = 
pattLength = 2 
response [] = {0,0,0,0,0} 
respOffset = 3 
respLength = 2 
searchRecord { ) 


2- shall either 

return 1 and response shall be: 

response={0,0,0,6,0} 

or shall 

return and response shall be: 

response={0,0,0,0,0} 
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35 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from a 

value in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS + 0x08 01 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall return 5 
response shall be: 
response={5,4,3,2,1} 




36 


Cyclic EF, Enhanced mode, search 

backward from given record, start from an 

offset in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS_GR + 0x0 03 

recordNum = 5 

patt [] ={0x02, 0x01, 0x00} 

pattOffset = 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 3 

respLength = 2 

searchRecord { ) 


shall either 

return 1 and response shall be: 

response={0,0,0,6,0} 

or shall 

return and response shall be: 

response={0,0,0,0,0} 




37 


Cyclic EF, Enhanced mode, search 

backward from given record, start from a 

value in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS_GR + 0x08 01 

recordNum = 3 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


Shall either 

return 5 and response shall be: 

response={3,2,1,5,4} 

or shall 

return 3 and response shall be: 

response={3,2,1,0,0} 





5.1 .1 .7 Method select (byte sfi) 

Test Area Reference: Api_l_Fvw_Slctb. 

5.1 .1 .7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void select {byte sfi) 

throws UICCException 

5.1.1.7.1.1 Normal execution 

• CRRNl : Selects a file by its Short File Identifier in the current directory of the File View. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: The current EF it self can be selected. 

• CRRN4: The file context associated with the File View object is changed after successful execution. 
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5.1.1.7.1.2 



Parameter errors 



CRRPl: If the file which sfi matches is not in the current directory or no file matches the sfi, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 



5.1.1.7.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.7.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_ Slctb.java. 
Api_l_Fvw_ Slctb _l.java. 
api_l_fvw_ slctb. cap. 



5.1.1.7.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,4 


N2 


Not testable 


N3 


3 


N4 


5 


P1 


4 


CI 


Not testable 


02 


Not testable 



5.1.1.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Selection possibilities, UICC file system 

1- get a FileView 

UICCSystem.getTheUICCView{CLEAR ON RESE 
T) 

2- select DFtest, fid=llll 

3- select with sfi EFtne, sfi = 0x01 

4- select with sfi EFtnd, sfi = 0x02 

5- select with sfi EFckd, sfi = 0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get a FileView 

UlCCSystem . getTheFileView {AID_ADF1 , CLEA 
R_ON_RESET) 

2- select DFtest, fid=llll 

3- select with sfi EFtne, sfi = 0x01 

4- select with sfi EFtnd, sfi = 0x02 

5- select with sfi EFcnd, sfi = 0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




3 


Current EF itself can be selected 

1- get a FileView 

UlCCSystem. getTheUICCView{CLEAR ON RESE 
T) 

2- select DFtest, fid=llll 

3- select with sfi EFtne, sfi = 0x01 

4- select with sfi EFtne, sfi = 0x01 


4- no exception shall be thrown 




4 


FILE_NOT_FOUND 

1- try to select a file with sfi=0x55 


1- shall throw an 

uicc.access. UICCException with 

reason code FILE NOT FOUND 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


File context changed 

1- select EFtaeu, sfi = 0x03 
read 3 first bytes 

2- select EFtkd, sfi = 0x02 
read file content 


1-file content should be 

{OxFF,OxFF,OxFF} 

2- file content should be 

{0x55,0x55,0x55} 





5.1.1.8 Method select (short fid) 

Test Area Reference: Api_l_Fvw_Slcts. 

5.1 .1 .8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public public void select {short fid) 
throws UICCException 

5.1.1.8.1.1 Normal execution 

• CRRNl : Selects a file of the UICC file system or of an ADF file system by file identifier. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: After selecting an ADF/MF/DF no EF is selected. 

• CRRN4: After selecting a linear fixed EF no record is selected. 

• CRRN5: Any file can be selected by FID which is an immediate child of the current directory. 

• CRRN6: Any DF can be selected by FID which is an immediate child of the parent of the current DP. 

• CRRN7: The parent of the current directory can be selected by the FID. 

• CRRN8: The ADF of the current active application can be selected by the FID. 

• CRRN9: The ADF/MF/EF can always be self selected. 

• CRRNIO: The file context associated with the File View object is changed after successful execution. 



5.1.1.8.1.2 

No requirements. 

5.1.1.8.1.3 



Parameter errors 



Context errors 



CRRCl: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN3, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

CRRC2: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN4, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

CRRC3: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN5, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

CRRC4: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 
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CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.8.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_l_Fvw_Slcts.java. 
Api_l_Fvw_Slcts_l .Java. 
api_l_fvw_slcts.cap. 



5.1.1.8.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


5 


N3 


5 


N4 


6 


N5 


1,2 


N6 


1,2 


N7 


1,2 


N8 


1,2 


N9 


4 


N10 


Tested in Api 1 Cent, test case 1 and 2 


C1 


3 


C2 


3 


C3 


3 


C4 


3 


C5 


Not testable 


C6 


Not testable 



5.1.1.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a FileView object, UICC file system 

1- get a FileView 

UICCSystem.getTheUICCView{CLEAR ON RESE 
T) 






1 


Selection possibilities 

1- select EFuicc, fid=2FF0 

2- select DFtest, fid=llll 

3- select EFcmj, fid=6F05 

4- select EFtaaa, fid=6F16 

5- select DFsub test, f id=2211 

6- select DFtest, fid=llll 

7- select EFtaaa, fid=6F16 

8- select DFtest, fid=llll 

9- select MF, fid=3F00 

10- select DFtest, fid=llll 

11- select EFtaaa, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get a FileView 

UICCSystem.getTheFileView{AID_ADFl,CLEA 
R_ON_RESET) 

2- select EFuicc, fid=2FF0 

3- select DFtest, fid=llll 

4- select EFcnu, fid=6F05 

5- select EFtaaa, fid=6F16 

6- select DFsub test, fid=2211 

7- select DFtest, fid=llll 

8- select EFtaaa, fid=6F16 

9- select DFtest, fid=llll 


No exception shall be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


No selection of unreachable file 

1- get a FileView 

UICCSystem.getTheUICCView{CLEAR ON RESE 
T) 

2- select EFcnu, fid=6F05 

3- select DFtest, fid=llll 

4- select EFtaa, fid=2222 

5- select EFcmj, fid=6F05 

6- select DFsub test, fid=2211 

7- select EFtaa, fid=2222 

8- select DFtelecom, fid=7F10 


2- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

3- No exception shall be thrown 

4- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

5- No exception shall be thrown 

6- No exception shall be thrown 

7- No exception shall be thrown 
8- A 

UICCException.FILE_NOT_FOUND 
shall be thrown. 




4 


Self selection 

1- select MF, fid=3F00 

2- select MF, fid=3F00 

3- select DFtest, fid=llll 

4- select DFtest, fid=llll 

5- select EFtaaa, fid=6F16 

6- select EFtaaa, fid=6F16 

7- get a FileView 

UICCSystem.getTheFileView{AID_ADFl,CLEA 
R_ON_RESET) 

8- select ADF, fid=7FFF 

9- select ADF, fid=7FFF 


2- No exception shall be thrown 
4- No exception shall be thrown 
6- No exception shall be thrown 

8- No exception shall be thrown 

9- No exception shall be thrown 




5 


EF not selected after MF/DF selection 

1- select MF, fid=3F00 

2- updateRecord { ) 

3- select DFtest, fid=llll 

4- updateRecord { ) 


2- A 

UICCException.NO_EF_SELECTED 
shall be thrown 
4- A 

UICCException.NO_EF_SELECTED 
shall be thrown 




6 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 

3- select EFlaeu, 

4 - recNumber = 

mode = REC_ACC_MODE_ CURRENT 

readRecord { ) 

5- select EFcaeu, 

6 - recNumber = 

mode = REC_ACC_MODE_ CURRENT 

readRecord { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 

5 - No exception shall be thrown. 

6 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 





5.1 .1 .9 Method select(short fid, byte[] fcp, short fcpOffset, short fcpLength) 

Test Area Reference: Api_l_Fvw_Slctb_bss. 

5.1 .1 .9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short select {short fid, 
byte [] fcp, 
short fcpOffset, 
short fcpLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 
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5.1.1.9.1.1 Normal execution 

CRRNl: Selects a file of the UICC file system or of an ADF file system as defined in TS 102 221 [5]. 

CRRN2: The method returns the FCP information in a form of a TLV structure as specified in TS 102 221 [5]. 

CRRN3: If the fcpLength is greater than the length of the response, the whole response is copied into the fcp 
buffer and the length of the response is returned by the method. 

CRRN4: If the fcpLength is smaller than the length of the response, the first part of the response is copied into 
the fcp buffer and the fcpLength is returned by the method. 

CRRN5: After selecting an ADF/MF/DF no EF is selected. 

CRRN6: After selecting a linear fixed EF no record is selected. 

CRRN7: After selecting a cyclic EF the last updated record is the first record. 

CRRN8: Any file can be selected by FID which is an immediate child of the current directory. 

CRRN9: Any DF can be selected by FID which is an immediate child of the parent of the current DF. 

CRRNIO: The parent of the current directory can be selected by the FID. 

CRRNl 1: The ADF of the current active application can be selected by the FID. 

CRRN12: The ADF/MF can always be selected. 

CRRNl 3: The file context associated with the File View object is changed after successful execution. 

CRRN14: The current file context of any other applets shall not be changed. This will be tested during the 
testing of the framework. 

5.1.1.9.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset plus fcpLength is greater than the length of the array fcp. length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

5.1.1.9.1.3 Context errors 

• CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules, an 
instance of UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.1.1.9.2 Test area files 

Test Source: Test_Api_l_Fvw_ Slctb_bss.java. 
Test Applet: Api_l_Fvw_ Slctb_bss _l.java. 

Cap File: api_l_fvw_ slctb_bss.cap. 
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5.1.1.9.3 



Test coverage 



CRR number 


Test case number 


N1 


1, 2, 3,4,5, 6,7,8, 14, 18,20,21 


N2 


1,2,3,4,5,6,7,8, 14, 18,20,21 


N3 


1 


N4 


2,3,4,5,6,7,8 


N5 


15,19 


N6 


17 


N7 


18 


N8 


14 


N9 


14 


N10 


14 


N11 


19,20 


N12 


20 


N13 


20 


N14 


1,2,3,4,5,6,7,8, 14, 18,20 


P1 


9 


P2 


10 


P3 


11 


P4 


12, 13 


C1 


16 


C2 


Not testable 


C3 


Not testable 



5.1.1.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a FileView object, UICC file system 

get a FileView 

FileView. getTheUICCView{CLEAR ON RESET) 






1 


Select EFtaru in MF (Transparent EF) 

Select DFtest 

select EFtaru, 

fid=6F03 

byte[] fcp = new byte [132] 

fcpOffset = 

fcpLength = 127 


Shall return at least 19. 

fcp[] shall contain following TLVs: 

1 . 82 02 41 21 //file descriptor 

2. 83 02 2F E2 //file id 

3. 8A 01 05 //life cycle status 

4. 80 02 00 OA // file size 




2 


Select EFtaru in MF (Transparent EF) 

select EFtaru, 
fid=6F03 
fcpOffset = 
fcpLength = 7 
select {) 


Shall return 7. 

fcp[] shall contain the first 7 bytes of 

the FCP structure and contain 

following TLV. 

1 . 82 02 41 21 //file descriptor 




3 


Select DFtest in MF 

fid = DFtest, fid=llll 
fcpOffset = 
fcpLength = 127 
select {) 


Shall return at least 17. 

fcp[] shall contain following TLVs 

1 . 82 02 78 21 //file descriptor 

2. 83 02 1 1 11 //file id 

3. 8A 01 05 //life cycle status 




4 


Select EFcaru in DFtest (Cyclic EF) 

select EFcaru, 
fid=6f09 
fcpOffset = 
fcpLength = 11 
select {) 


Shall return: 1 1 

fcp[] shall contain following TLV: 

82 05 46 21 00 03 02 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Select ADF1 

select ADF 

fid=7FFF 

fcp [0:5] =0x00 

fcpOffset=5 

fcpLength=127 

select 


Shall return: at least 27 

The first 5 bytes of fcp[] shall be 0x00 

and contains following TLVs: 

1 . 82 02 78 21 //file descriptor 

2. 84 1 AO 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A 01 05 //life cycle 




6 


Select MF 

select MF, 
fid= 3F00 
fcpOffset = 
fcpLength = 11 
select {) 


Shall return: 1 1 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




7 


Select DFtelecom in MF 

select DFtelecom, 

fid=7F10 

fcp[0] = fcp[l] = 0x05 

fcpOffset = 2 

fcpLength = 13 

select {) 


Shall return 13. 

The first 2 bytes of fcp[] shall be 0x05 

and fcp[] shall contain following TLVs 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 10 //file id 




8 


Select EFlaru in DFtelecom (Linear FixedEF) 

select EFlaru, 
fid = 6F0C 
fcpOffset = 
fcpLength = 14 


Shall return 14. 

fcp[] shall contain following TLVs: 

1.82 05 42 21 00 04 02 

2. 83 02 6F0C 




9 


fcp is null 

select EFlaru, 

fid = 6F0C 

byte [] nullBuf fer = null 

fcpOffset = 

fcpLength = 15 


Shall throw 
java.lang.NullPointerException 




10 


fcpOffset < 

select EFlaru, 
fid = 6F0C 
fcpOffset = -1 
fcpLength = 15 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




11 


fcpLength < 

select EFlaru, 
fid = 6F0C 
fcpOffset = 
fcpLength = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




12 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 
fid = 6F0C 
fcpOffset = 115 
fcpLength = 18 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




13 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 

fid = 6F0C 

fcpOffset = fcpLength + 1 

fcpLength = 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Selection possibilities 

0- select MF, fid=3F00 

1- select EFnicc, fid=2FF0 

2- select DFtest, fid=llll 

3- select EFcmj, fid=6F05 

4- select EFtaaa, fid=6F16 

5- select DFsub_test, fid=2211 

6- select DFtest, fid=llll 

7- select EFtaaa, fid=6F16 

8- select DFtest, fid=llll 

9- select MF, fid=3F00 

10- select DFtest, fid=llll 

11- select EFtaaa, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown. 




15 


EF not selected after MF/DF selection 

1- select MF, 
fid = 3F00 
select EFicciD, 
fid = 2FE2 
2 - select MF 
fid = 3F00 
select {) 
readBinary { ) 


2 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 




16 


No selection of non-reachable file 

1 - select MF, 
fid = 3F00 

2 - select EFcaeu, 
fid= Ox6F09 


2 - Shall throw 

uicc.access.UICCException with 
reason code FILE_NOT_FOUND. 




17 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 
fid=llll 

3- select EFlaeu, 
fid=6F0C 

4 - recNumber = 

mode = REC_ACC_M0DE_ CURRENT 

readRecord { ) 


4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND. 




18 


Record pointer in selected cyclic EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 
fid=llll 

3- select EFcaeu, 
fid=6F09 

4- byte[] datal = { 1,2,3 } 
mode = REC_ACC_M0DE_PREVI0US 
updateRecord (datal) 

5- select EFcaeu 
fid = 6F09 
select {) 

mode = REC_ACC_MODE_PREVIOUS 
readRecord { ) 
readRecord {data2 ) 
compare datal to data2 

6- restore original data of EFcaeu 


5 - The contents of datal and data2 
shall be identical. 




19 


EF not selected after ADF/DF selection 

1- get a FileView 

UICCSystem.getTheFileView{AID_ADFl, CLEAR 
_ON_RESET) 

2- select ADF, 
fid = 7FFF 
select EFnicc 
fid = 2FF0 

3 - select ADF 
fid = 7FFF 
select {) 
readBinary { ) 


3 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Reselection 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select ADF, fid=7FFF 

2- Using the UICC FileView 
select MF, fid=3F00 
select MF, fid=3F00 

3- select DFtest, fid=llll 
select DFtest, fid=llll 

5- select EFtaaa, fid=6F16 
select EFtaaa, fid=6F16 


No exceptions shall be thrown 




21 


Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFtest, fid=llll 
select EFlaeri, fid=6FAl 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFtest, fid=llll 
select EFtarr3, fid=6FB3 


1 - fcp[] shall contain the following TLV 

8B 03 AC 00 01 or 

8B 06 AC 00 00 01 01 01 

2- fcp[] shall contain the following TLV 

8B 03 AC 00 03 or 

88 06 AC 00 00 03 01 03 





5.1.1.10 Method status 

Test Area Reference: Api_l_Fvw_Stat. 

5.1.1.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short status {byte [] fcp, 

short fcpOffset, 
short fcpLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 



5.1.1.10.1.1 



Normal execution 



• CRRNl : The method returns the File Control Parameter of the current selected DF/MF or ADF as defined in 
TS 102 221 [5]. 

• CRRN2: If the fcpLength is greater than the length of the response, the whole response is copied into the 
fcp buffer and the length of the response is returned by the method. 

• CRRN3: f the f cplength is smaller than the length of the response, the first part of the response is copied 
into the fcp buffer and the fcpLength is returned by the method. 

5.1.1.10.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset+fcpLength is greater than fcp. length an ArraylndexOutOfBoundsException shall be 
thrown. 
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5.1.1.10.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.10.3 



Test area files 

Test_ Api_l_Fvw_Stat.java. 
Api_l_Fvw_Stat_l .Java. 
Api_l_Fvw_Stat.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2, 3, 4, 5, 11 


N2 


2,3 


N3 


1,4 


PI 


6 


P2 


7 


P3 


8 


P4 


9, 10 


CI 


Not testable 


C2 


Not testable 



5.1.1.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Status of MF 

1- Get a FileView object, UICC file get 
a FileView 

FileView. getTheUICCView{CLEAR_ON_RESET) 

2- select MF 

byte[] fcp = new byte [127] 
fcp[0:2]= OxCC 
fcpOffset = 3 
fcpLength = 11 
status {) 


2- Shall return 1 1 . 

The first 3 bytes of fcp[] shall contain 

OxCC. 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




2 


Status after select EFtaru in MF 

1 - select DFtest 
select EFtaed, fid = 6F03 
fcpOffset = 
fcpLength = 127 
select {) 
status {) 


1- Shall return at least 19. 
fcp[] shall contain following TLVs: 
1 . 82 02 38/78 21 //file descriptor 
2.83 02 11 11 //file ID 




3 


Status of DFtelecom 

1 - fid = 7F10 
fcpOffset = 
fcpLength = 127 
status {) 


1 - 

Shall return at least 17 and the entire 
structure of the file control parameters. 
The file identifier shall be contain the 
fid of DFtelecom. 




4 


Status DFtelecom 

Select DFtelecom, fid=7F10 
fcpOffset = 
fcpLength = 11 
status {) 


Shall return 11. 

fcp shall contain the first 1 1 bytes of 
the FCP structure starting at index 0. 
fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 10 //file id 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Status ADF1 

select ADF, fid=7FFF 
fcpOffset = 
fcpLength = 127 


Shall return at least 27 

fcp[] shall contain the entire FCP 

structure 

fcp[] shall contain following TLVs: 

1 . 82 02 78 21 //file descriptor 

2. 84 1 AG GO GG OG 09 00 05 FF FF 
FF FF 89 60 00 00 GO //DF Name 

3. 8A 01 05 //life cycle 




6 


fcp is null 

byte[] nullBuffer = null 
fcpOffset = 
fcpLength = 34 
status {) 


Shall throw 
java.lang.NullPointerException. 




7 


fcpOffset < 

fcpOffset = -1 
fcpLength = 34 
status { ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




8 


fcpLength < 

fcpOffset = 
fcpLength = -1 
status { ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




9 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length-1 
fcpLength = 15 
status {) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




10 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length+1 
fcpLength = 
status {) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




11 


Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFtest, 

select DFaHR2, 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFtest, 

select DFme4, 


1 - fcp[] shall contain the following TLV 

8BG3ACG0G2 or 

8B G6 AC GO GG G2 G1 02 

2- fcp[] shall contain the following TLV 

8BG3ACG0G4 or 

8B G6 AC GO GG G4 G1 04 





5.1 .1 .11 Method updateBinary 

Test Area Reference: Api_l_Fvw_Updb. 

5.1 .1 .1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void updateBinary {short fileOffset, 

byte [] data, 
short dataOffset, 
short dataLength) 
throws Java. lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
UICCException 

5.1.1.11.1.1 Normal execution 

• CRRNl : Updated the data bytes of the current selected transparent EF. 
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5.1.1.11.1.2 



Parameter errors 



CRRPl: If recOffset is less than 0, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.OUT_OF_F I LE .BOUNDARIES. 

CRRP2: : If fileOffset plus dataLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE .BOUNDARIES. 

CRRP3: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 



5.1.1.11.1.3 



Context errors 



CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be UICCException. 

SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating of 
a deactivated file, an instance of UICCException shall be thrown. The reason code shall be UICCException. 

REF_DATA_INVALIDATED. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.1.1.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.11.3 



Test area files 

Te s t_ Api_ 1 _Fv w_Updb .Java. 
Api_l_Fvw_Updb _Ljava. 
api_ 1 _fvw_updb .cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


C1 


1 


C2 


10 


C3 


11 


C4 


12 


C5, 


Not Testable 


C6 


Not Testable 
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5.1.1.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC FlleView 

FileView.getTheUICCView {CLEAR ON RESET) 







1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
NO_EF_SELECTED. 


1 


2 


Update Transparent EF 

1- select DFtest, fid = 1111 

2- select EFtaeu, fid = 6F03 

3- fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 

4- fileOffset = 3 
respOffset = 
respLength = 1 
readBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


fileOffset = 254 

1- fileOffset = 254 
data[0] = '55' 
data[l] = 'AA' 
data [2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary { ) 

2- fileOffset = 254 
respOffset = 
respLength = 3 
readBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1 ] = 'AA' 
resp[2] = '66' 




4 


Offset into File out of bounds 

fileOffset = -1 

dataOffset = 
dataLength = 10 
updateBinary { ) 


Shall throw 

uicc.access.UICCException with 
reason code 
OUT OF FILE BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte[] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary { ) 


Shall throw 
java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 
dataOffset = -1 
dataLength = 10 
updateBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




10 


EF is not Transparent 

1- select DFtest, fid = 1111 

2- select DFlaeu, fid = 6F0C 
3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uicc.access.UICC 
Exception with reason code 
COMMAND INCOMPATIBLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Access condition not fulfilled 

1- select DFtest, fid = 1111 

2- select EFtnh, fid = 6F02 

3- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw 

ulcc.access.UICCExceptlon with 
reason code 

SECURITY STATUS NOT SATISFIE 
D. 




12 


EF is deactivated 

1- select EFthe, fid = 6F01 
deactiveFile { ) 

2- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 

3- activateFile {) 


1- No exception shall be thrown. 

2- Shall throw 

ulcc.access.UICCExceptlon with 
reason code 
REF_DATA_INVALIDATED 

3- No exception shall be thrown. 





5.1.1.12 Method updateRecord 

Test Area Reference: Api_l_Fvw_Updr. 

5.1.1.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void updateRecord { short recNumber, 

byte mode, 
short recOffset, 
byte [] data, 
short dataOffset, 
short dataLength) 
throws Java. lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
UICCException 

5.1.1.12.1.1 Normal execution 

• CRRN 1 : Reads a record or a part of record of the current linear fixed or cyclic EF into byte array data[] . 

• CRRN2: If the access mode is REC_ACC_MODE_ CURRENT the current selected record will be updated. 
The current record pointer shall not be changed. 

• CRRN3:If the access mode is REC_ACC_MODE_ ABSOLUTE and the file is linear fixed EF, the record 
addresss by recNumber will be updated. The current record pointer shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF the next record 
relative to the current selected record will be selected and updated. The record pointer shall be updated. 

• CRRN5: If the access mode is REC_ACC_MODE_NEXT and the record pointer has not been previously set 
within the selected EF, the record pointer shall be set to the first record and this record should be updated. 

• CRRN6: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and updated. The record pointer shall be updated. 

• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS and the record pointer has not been previously 
set within the selected EF, then the record pointer should be set to the last record in this EF. This record should 
be updated. 

• CRRN8: If the access mode is REC_ACC_MODE_PREVIOUS, the file is a cyclic EF, the oldest record will 
be updated independent of the current record pointer and this record becomes record number 1 and the current 
record. 
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5.1.1.12.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE .CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException. RECORD_NOT_FOUND. 

• CRRP4: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record; an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus dataLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUNDARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an 
instance of UICCException shall be thrown. The reason code shall be UICCException.INVALID_MODE. 

• CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 
REC_ACC_MODE_PREVIOUS, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODEorUICCException.COMMAND_INCOMPATIBLE. 

• CRRP9: If the array data is null, an instance of NullPointerException shall be thrown. 

• CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

5.1.1.12.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be UICCException. 
SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating an 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be UICCException. 
REF_DATA_INVALIDATED. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.1.1.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.1.12.3 



Test area files 

Test_Api_l_Fvw_Updr.java. 
Api_ 1 _Fvw_ Updr_ 1 .j ava. 
api_ 1 _fvw_updr.cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,7,8, 10 


N2 


2 


N3 


3 


N4 


5 


N5 


4 


N6 


7,8,9, 10 


N7 


7 


N8 


10 


P1 


11 


P2 


12 


PS 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5 


Not testable 


C6 


Not testable 
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5.1.1.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC FileView 

FileView.getTheUICCView {CLEAR ON RESET) 






1 


No EF selected 

RecNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] data = new byte [20] 

dataOffset = 

dataLength = 10 

updateRecord { ) 


Shall throw uicc.access.UICC Exception 
with reason code NO_EF_SELECTED. 




2 


Update Absolute from Linear Fixed EF 

1- select DFtest, fid = 1111 

2- select EFlaeu, fid = 6F0C 
// Record pointer not set. 

3- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 

data [0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord { ) 

respOffset = 

respLength = 

readRecord { ) 

4- // verify result 
read respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_CURRENT 
readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 
4-Respshallbe:11 111111 




3 


Update Current from Linear Fixed EF 

1- select DFtest, fid = 1111 

2- select EFlaru, fid = 6F0C 

// Set record pointer with mode "next" . 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = '00' 

dataOffset = 

dataLength = 4 

updateRecord { ) 

// write data with mode "current" 

4- recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODECURRENT 
updateRecord { ) 

5- //verify result 
respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_ CURRENT 
readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

5- No exception shall be thrown. 

resp shall be: 

resp[0] = '22' 

resp[1] = '22' 

resp[2] = '22' 

resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no 
record pointer set 

1- select DFtest, fid = 1111 

2- select EFlaru, fid = 6F0C 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data [0:3] = '33' 

dataOffset = respOffset = 

dataLength = respLength = 4 

updateRecord { ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

4-// verify result 

readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

4- No exception shall be thrown. 

resp shall be: 

resp[0] = '33' 

resp[1] = '33' 

resp[2] = '33' 

resp[3] = '33' 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Update Next from Linear Fixed EF, record 








pointer set 


1- No exception shall be thrown. 






1- recNumber = 








mode = REC_ACC_MODE_NEXT 








recOffset = 








data [0:3] = '44' 
dataOffset = 


2- No exception shall be thrown. 






dataLength = 4 


resp shall be: 






updateRecord { ) 


resp[0] = '44' 






2- //verify result 


resp[1 ] = '44' 






readRecord { ) 


resp[2] = '44' 
resp[3] = '44' 




6 


Update Next from Linear Fixed EF, no more 
records 








recNumber = 


Shall throw uicc.access.UICCException 






mode = REC_ACC_MODE_NEXT 


with reason code 






recOffset = 


RECORD_NOT_FOUND. 






data [0:3] = '55' 








dataOffset = 








dataLengtli = 4 








updateRecord { ) 






7 


Update Previous from Linear Fixed EF, no 
record pointer set 








1- select DFtest, fid = 1111 


1- No exception shall be thrown. 






2- select EFlsru, fid = 6F0C 


2- No exception shall be thrown. 






3- recNumber = 


3- No exception shall be thrown. 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 








data [0:3] = '66' 








dataOffset = respOffset = 








dataLengtli = respLengtli = 4 


4- No exception shall be thrown. 






updateRecord { ) 


resp shall be: 






4- //verify result 


resp[0] = '66' 






readRecord { ) 


resp[1] = '66' 
resp[2] = '66' 
resp[3] = '66' 




8 


Update Previous from Linear Fixed EF, 
record pointer set 








1- recNumber = 


1- No exception shall be thrown 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 
data [0:3] = '77' 


2- No exception shall be thrown. 






dataOffset = respOffset = 


esp shall be: 






dataLengtli = respLength = 4 


resp[0] = '77' 






updateRecord { ) 


resp[1] = '77' 






2- //verify result 


resp[2] = '77' 






readRecord { ) 


resp[3] = '77' 




9 


Update Previous from Linear Fixed EF , no 
more records 








recNumber = 


Shall throw 






mode = REC_ACC_MODE_PREVIOUS 


sim. access. SIMViewException with 






recOffset = 


reason code RECORD_NOT_FOUND. 






data [0:3] = '88' 








dataOffset = respOffset = 








dataLengtli = respLengtli = 4 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Update Previous from Cyclic EF 

1- select DFtest, fid = 1111 

2- select EFcaru, fid = 6F09 

3- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 

4- recNumber = 2 

mode = REC ACC MODE PREVIOUS 
data[0:2] = ' FF ' 
dataOffset = 
dataLength = 3 
updateRecord { ) 

5- //verify result 
readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 

5- No exception shall be thrown, 
resp shall be: 

resp[0] = 'FF'resp[1] = 'FF' 
resp[21 = 'FF' 




11 


Update Absolute from Linear Fixed EF 
beyond Records 

1- select EFlaru, fid = 6F0C 

2 -recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord { ) 

3- recNumber = 3 

updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 

3- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




12 


No current record in linear fixed EF, update 
current 

1- select EFlaru, fid = 6F0C 
// No curr rec 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE _CURRENT 
recOffset = 

dataOffset = 
dataLength = 4 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




13 


recOffset < 

1- select EFlaru, fid = 6F0C 

2- recNumber =1 // rec 1 
mode = REC_ACC_MODE_ABSOLUTE 
dataOffset = 
dataLength = 4 
updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




14 


recOffset + dataLength > record.length 

1- select EFlaru, fid = 6F0C 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




15 


Updating with invalid mode 

1- select EFlaru, fid = 6F0C 

2- recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord { ) 

3- mode = 5 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - Shall throw uicc.access.UICC 
Exception with reason code 
INVALID_MODE. 

3 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID MODE. 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Updating Cyclic EF with invalid mode 

1- select DFtest, fid = 1111 

2- select EFcaeu, fid = 6F09 

set record pointer to record nr 1 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord { ) 

4- recNumber = 

mode = REC_ACC_MODE_CURRENT 
updateRecord { ) 

5- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
updateRecord { ) 

6- recNumber = 
mode = 5 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMANDJNCOMPATIBLE. 

4 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMANDJNCOMPATIBLE. 

5 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMANDJNCOMPATIBLE. 

6 - Shall throw uicc.access. UICC 
Exception with reason code 
INVALID MODE or 
COMMAND INCOMPATIBLE. 




17 


data[] is null 

data[] = null 
dataOffset = 
dataLength =10 
updateRecord { ) 


Shall throw 
java.lang.NullPointerException. 




18 


dataOffset < 

dataOffset = -1 
dataLength = 10 
updateRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


dataLength < 

dataOffset = 
dataLength = -1 
updateRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1- select DFtest, fid = 1111 

2- select EFtne, fid = 6F01 

3- dataOffset = 
dataLength = 4 
updateRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uii. access. UICC 
Exception with reason code 
COMMAND INCOMPATIBLE. 




22 


Access condition not fulfilled 

1- select EFcHu, fid = 6F05 

2- recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_M0DE_PREVI0US 
updateRecord { ) 

3- fid = EFLNU 
select { ) 

4- recNumber = 1 

mode = REC_ACC_M0DE_ CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access. UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 

3- No exception shall be thrown. 

4- Shall throw uicc.access. UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


EF is deactivated 

1- select EFcHR, fid = 6F04 
invalidate { ) 

2- updateRecord { ) 

3- activateFile {) 

4- restore the file content EFlaeu, EFcaeu 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
codeREF_DATA_INVALIDATED 

3- No exception shall be thrown. 




24 


Restore the file content 

1- restore the file content of EFlaru: 
record 1 = 0x55,0x55,0x55,0x55 
record 2 = OxAA, OxAA, OxAA, OxAA 

2- restore the file content of EFcaei : 
record 1 = 0x55,0x55,0x55,0x55 
record 2 = OxAA, OxAA, OxAA, OxAA 







5.1.2 Interface U I CCConstants 

This interface hold all the constants defined in TS 102 221 [5]. No test of constants will be performed. 

5.1.3 Interface U I CCSystem 
5.1 .3.1 Method getTheUICCView 

Test Area Reference: Api_l_Usy_Getfb. 

5.1 .3.1 .1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static FileView getTheUICCView {byte event) 

throws j avacard . framework . SystemException 

5.1.3.1.1.1 Normal execution 

CRRNl: returns a reference to class which implements the FileView interface on the UICC file system. 

CRRN2: return null if one of the javacard.framework. Applet. register(..) method has not previously invoked by 
the applet invoking this method or the file system server returns null. 

CRRN3: It is not possible to get access to files which are located under any ADF with this FileView. 

CRRN4: After a successful invocation of the method, the MF is the current selected file. 

CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object. 



5.1.3.1.1.2 



Parameter errors 



CRRPl: If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 



5.1.3.1.1.3 



Context errors 



• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 
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5.1.3.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.3.1.3 



5.1.3.1.4 



Test area files 

Test_ Api_l_Usy_Getfb.java. 
Api_l_Usy_Getfb_l .Java. 
api_l_usy_getfb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1 


N3 


2 


N4 


2 


N5 


3 


PI 


7 


CI 


5,6 


C2 


4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Method returns null 

Install Appletl with full access rights on 
the UICC file system 








Invoke the method getTheUICCView before 
the javacard. framework. Applet . register { . . ) 


The method returns null 






method invocation 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Normal execution 








1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getTheUICCView { ) with 


No exception shall be thrown 






the event JCSystem.NOT_A_TRANSIENT_OBJECT 








and stores the result in a class variable 








FVl 


Current selected DF is the IVIF 






Appletl calls FVl. status {) command 








Select DFTest using FVl 








Select EFtaeu using FVl 

Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








2- Envelope menu selection is sent to the 
UICC 


2- Appletl is triggered 






Appletl calls FVl. status {) command 


Current selected DF is DFjest 






Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Appletl calls FVl . select {Ox7FFF) 


UICCException.FILE_NOT_FOUN 
D is thrown 






Invoke the method getTheUICCView { ) with 
the event JCSystem. CLEAR_ON_RESET and 


No exception shall be thrown 






stores the result in a class variable FV2 








Appletl calls FV2. status {) command 








Select DFTest using FV2 


Current selected DF the IVIF 






Select EFtaru using FV2 








Read first 3 bytes using FV2 








Reset 


Expected value is {FF FF FF} 






Terminal profile 








4 - Envelope menu selection is sent to the 








UICC 








Appletl calls FV2. status {) command 


4- Appletl is triggered 






Read first 3 bytes using FV2 


Current selected DF is the IVIF 
UlCCException. 






Appletl calls FV2 . select {Ox7FFF) 


NO_EF_SELECTED 






5- Select the Applet by AID 


UlCCException. FILE_NOT_FOUN 
D is thrown 






Invoke the method in the method process {) 








getTheUICCView {) with the event 


5- Appletl is selected 






JCSystem. CLEAR_ON_DESELECT and stores the 








result in a class variable FV3 


No exception shall be thrown 






Appletl calls FV3. status {) command 








Select DFTest using FV3 








Select EFtaru using FV3 








Read first 3 bytes using FV3 


Current selected DF the MF 






Select ADF2 by AID 








6- Select the Applet by AID 


Expected value is {FF FF FF} 






Appletl calls FV3. status {) command 








Read first 3 bytes using FV3 


6- Appletl is selected 
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Id 


Description 


API Expectation 


APDU Expectation 




Appletl calls FV3. select {0X7FFF) 


Current selected DF is the MF 

UlCCException. 
NO EF SELECTED 
UlCCException. FILE_NOT_FOUN 
D is thrown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different {FVl != FV2 != FV3 ) 

3- Select DFTest/EFLARu using FVl 

4- Select DFTest/EFcARu using FV2 

5- Select DFTest/EFcaRu using FV3 

6- Read record number 1 using FVl {in 
absolute mode) 

7- Read record number 2 using FV2 {in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- A security exception shall be 
thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheUICCView { ) method 
with the event JCSystem. CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- System Exception. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE System Exception 
witii CLEAR_ON_RESET FileView object 

1- Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory {MEMORY 
TYPE_TRANS I ENT_RESET ) 

2- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_RESET) 

3- Applet calls method getTheUICCView { ) 
with event 

JCSystem . CLEAR_ON_RESET 

4- Reset 


1- No exception shall be thrown 

2- No exception shall be thrown 

3- System Exception. 
NO_TRANSIENT_SPACE is 
thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE System Exception 
with CLEAR_ON_DESELECT FileView object 

1- Select the Applet by AID 

2- Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory {MEMORY 
TYPE_TRANSIENT_DESELECT) 

3- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_DESELECT) 

4- Applet calls method getTheUICCView { ) 
with event 

JCSystem . CLEAR_ON_DESELECT 


1- Appletl is selected 

2- No exception shall be thrown 

3- No exception shall be thrown 

4- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getTheUICCView { ) with 
event different from 0,1,2 


1- 

System Exception. ILLEGAL_VALU 

E is thrown 





5.1 .3.2 Method getTheFileView 

Test Area Reference: Api_l_Usy_Getfob. 

5.1.3.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static FileView getTheFileView {javacard. framework. AID aid, byte event) 
throws NullPointerException, 

j avacard . framework . SystemException 



5.1.3.2.1.1 



Normal execution 



• CRRNl: returns a reference to class which implements the FileView interface on an ADF file system defined 
by its AID. 

• CRRN2: returns null if the ADF with the AID does not exist. 

• CRRN3: returns null if one of the javacard. framework. Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

• CRRN4: After a successful invocation of the method the ADF is the currently selected file. 

• CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object. 

• CRRN6: It is not possible to access files which are not located under the ADF. 

5.1 .3.2.1 .2 Parameters error 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_VALUE. 

• CRRP2: If the AID is null a NullPointerException shall be thrown. 
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5.1.3.2.1.3 



Context errors 



CRRCl: If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 



5.1.3.2.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_ Api_l_Usy_Getfob.java. 

Api_l_Usy_Getfob.java. 

api_l_usy_getfob.cap. 



5.1.3.2.3 



Test coverage 



5.1.3.2.4 



CRR number 


Test case number 


N1 


1 to 3 


N2 


1 


N3 


1 


N4 


2 


N5 


3 


N6 


2 


PI 


7 


P2 


8 


CI 


5,6 


C2 


4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIetliod returns null 

1- Install Appletl with full access rights 
on the UICC file system 








2- Invoke the method getTheFileView 
before the 


2- returns null 






javacard. framework. Applet . register { . . ) 








method invocation 








3- Envelope menu selection is sent to the 








UICC 


3- applet is triggered 






4- Invoke the method getTheFileView { ) with 








AID = unknown ADF AID 


4- returns null 
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Id 



Description 



API Expectation 



APDU Expectation 



Normal execution 

1- Envelope menu selection is sent to the 
UICC 

Invoke the method getTheFileView { ) with 

AID = ADFl with the event 

JCSystem . NOT_A_TRANSIENT_OBJECT 

and stores the result in a class variable 

FVl 

Appletl calls FVl. status {) command 



Select DFTest using FVl Select EFtaeu using 
FVlRead first 3 bytes using 
FVlResetTerminal profile 

2 - Envelope menu selection is sent to the 
UICC 

Appletl calls FVl. status {) command 

Read first 3 bytes using FVl 
Appletl calls FVl . select {0x3F00) 



Invoke the method getTheFileView { ) with 
the event JCSystem. CLEAR_ON_RESET and 
stores the result in a class variable FV2 

Appletl calls FV2. status {) command 

Select DFiest using FV2 
Select EFxiRu using FV2 
Read first 3 bytes using FV2 

Reset 

Terminal profile 

4 - Envelope menu selection is sent to the 
UICC 

Appletl calls FV2. status {) command 

Read first 3 bytes using FV2 



Appletl calls FV2 . select {0x3F00) 



5- Select the Applet by AID 

Invoke the method getTheFileView { ) with 

AID = ADFlwith 

theevent : JCSystem . CLEAR_ON_DESELECT and 

stores the result in a class variable FV3 

Appletl calls FV3. status {) command 

Select DFiest using FV3 Select EFtahd using 

FV3 

Read first 3 bytes using FV3 



6- Select the Applet by AID 
Appletl calls FV3. status {) command 
Read first 3 bytes using FV3 

Appletl calls FV3 .select {0x3F00) 



1- Appletl is triggered 

No Exception sliall be thrown 

Current selected DF is ADF1 



Expected value is {FF FF FF} 

2- Appletl is triggered 
Current selected DF is DFjest 
Expected value is {FF FF FF} 



UICCException.FILE_NOT_FOUN 

D is thrown 

No exception shall be thrown 



Current selected DF is the ADF1 



Expected value is {FF FF FF} 



4- Appletl is triggered 

Current selected DF is the ADF1 

UlCCException. 
NO EF SELECTED 



UICCException.FILE_NOT_FOUN 
D is thrown 



5- Appletl is selected 

No Exception shall be thrown 
Current selected DF is ADF1 
Expected value is {FF FF FF} 

6- Appletl is selected 
Current selected DF is ADF1 
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Id 


Description 


API Expectation 


APDU Expectation 






UlCCException. 
NO_EF_SELECTED 

UICCException.FILE_NOT_FOUN 
D is thrown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different {FVl != FV2 != FV3 ) 

3- Select DFTest/EFLaRu using FVl 

4- Select DFTest/EFcaEu using FV2 

5- Select DFTest/EFcARu using FV3 

6- Read record number 1 using FVl {in 
absolute mode) 

7- Read record number 2 using FV2 {in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- A security exception shall be 
thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheFileView { ) method 
with the event JCSystem. CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1 Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory {MEMORY_ 
TYPE_TRANS IENT_RESET ) 

2- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_RESET) 

3- Applet calls method getTheFileView { ) 
with AID = ADFl 

with event 
JCSystem . CLEAR_ON_RESET 

4- Reset 


1- No Exception shall be thrown 

2- No Exception shall be thrown 

3- SystemException. 
NO_TRANSIENT_SPACE Is 
thrown 




6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory {MEMORY_ 
TYPE_TRANSIENT_DESELECT) 

3- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR ON DESELECT) 

} 

4- Applet calls method getTheFileView { ) 
with AID = ADFl 

with event : 
JCSystem. CLEAR_ON_DESELECT 


1 - Appletl Is triggered 

2- No Exception shall be thrown 

3- No Exception shall be thrown 

4- SystemException. 
NO_TRANSIENT_SPACE Is 
thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getTheFileView { ) with 
event different from 0,1,2 


1- 

SystemException.lLLEGAL_VALU 
E is thrown 




8 


NullPointerException 

Invoke the method getTheFileView { ) with 
AID = NULL 

with event : 
1 - JCSystem.CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 





5.1 .3.3 Method getTheFileView 

Test Area Reference: Api_l_Usy_Getf_Bsbb. 

5.1.3.3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static FileView getTheFileView {byte [] buffer, short bOffset, short bLength, byte event) 
throws NullPointerException, 

j avacard . framework . SystemException, 
ArraylndexOutOfBoundException 



5.1.3.3.1.1 



Normal execution 



• CRRNl: returns a reference to class which implements the FileView interface on an ADF file system defined 
by its AID contains in buffer parameter. 

• CRRN2: returns null if the ADF with the full AID given in the buffer does not exist. 

• CRRN3: returns null if one of the javacard.framework.Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

• CRRN4: After a successful invocation of the method the ADF is the currently selected file. 

• CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object. 

• CRRN6: It is not possible to access files which are not located under the ADF. 

5.1.3.3.1.2 Parameters error 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_VALUE. 

• CRRP2: If the buffer is null a NullPointerException shall be thrown. 

• CRRP3: If bOffset is less than 0, an instance ArraylndexOutOfBoundException shall be thrown. 

• CRRP4: if bOffset plus bLength is greater than the length of the array buffer.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: if bLength is not in the range of 5 - 16 bytes a SystemException.ILLEGAL_VALUE shall be thrown. 
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5.1.3.3.1.3 



Context errors 



• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 

5.1.3.3.2 Test area files 

Test Source: Test_ Api_l_Usy_Getf_Bsbb.java. 
Test Applet: Api_l_Usy_Getf_Bsbb.java. 

Cap File: api_l_usy_getf_bsbb.cap. 



5.1.3.3.3 



Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1 


N3 


2 


N4 


2 


N5 


3 


N6 


2 


PI 


7 


P2 


8 


P3 


9 


P4 


9 


P5 


10 


CI 


5,6 


C2 


4 



5.1.3.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIethod returns null 

1- Install Appletl with full access rights 
on the UICC file system 

2- Invoke the method getTheFileView 
before the 

javacard. framework. Applet . register { . . ) 

method invocation 

Invoke the method getTheFileView { ) with 

buffer [20] = {ADFl,...} 

bOffset= 

bLength= 16 

3- Envelope menu selection is sent to the 
UICC 

4- Invoke the method getTheFileView 
before the 

javacard. framework. Applet . register { . . ) 

method invocation 

Invoke the method getTheFileView { ) with 

buffer [20] = null 

bOffset= 

bLength= 16 


2- returns null 

3- Applet is triggered 

4- returns null 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Normal execution 

1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getTheFileView { ) 

with buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

JCSystem . NOT_A_TRANSIENT_OBJECT 

and stores the result in a class variable 

FVl 


No Exception sliall be thrown 






Appletl calls FVl. status {) command 


Current selected DF is ADF1 






Select DFxest using FVl 
Select EFtaru using FVl 
Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 

Terminal profile 








2 - Envelope menu selection is sent to the 
UICC 

Appletl calls FVl. status {) command 

Read first 3 bytes using FVl 


2- Appletl is triggered 
Current selected DF is DFjest 
Expected value is {FF FF FF} 






Appletl calls FVl . select {0x3F00) 


UICCException.FILE_NOT_FOUN 
D is thrown 






Invoke the method getTheFileView { ) with 
the event JCSystem. CLEAR_ON_RESET and 
stores the result in a class variable FV2 


No exception shall be thrown 






Appletl calls FV2. status {) command 


Current selected DF is ADF1 






Select DFTest using FV2 
Select EFtaru Using FV2 
Read first 3 bytes using FV2 

Reset 

Terminal profile 


Expected value is {FF FF FF} 






4 - Envelope menu selection is sent to the 
UICC 

Appletl calls FV2. status {) command 

Read first 3 bytes using FV2 


4- Appletl is triggered 

Current selected DF is ADF1 

UlCCException. 
NO_EF_SELECTED 






Appletl calls FV2 . select {0x3F00) 

5- Select the Applet by AID 

Invoke the method getTheFileView { ) with 

AID = ADFl with 

buffer [20] = {ADFl,...} 

bOffset= 

bLength= 16 

the event: JCSystem. CLEAR_ON_DESELECT and 

stores the result in a class variable FV3 


UICCException.FILE_NOT_FOUN 

D is thrown 

5- Appletl is selected 

No Exception shall be thrown 






Appletl calls FV3. status {) command 

Select DFiest using FV3 

Select EFtaru using FV3 

Read first 3 bytes using FV3 


Current selected DF is ADF1 
Expected value Is {FF FF FF} 






6- Select the Applet by AID 
Appletl calls FV3. status {) command 
Read first 3 bytes using FV3 


6- Appletl is selected 
Current selected DF is ADF1 
UlCCException. 
NO EF SELECTED 
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Id 


Description 


API Expectation 


APDU Expectation 




Appletl calls FV3. select {0x3F00) 


UICCException.FILE_NOT_FOUN 
D is thrown 




3 


FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different {FVl != FV2 != FV3 ) 

3- Select DFTest/EFLARu using FVl 

4- Select DFTest/EFcAEu using FV2 

5- Select DFTest/EFcsEu using FV3 

6- Read record number 1 using FVl {in 
absolute mode) 

7- Read record number 2 using FV2 {in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- A security exception shall be 
thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheFileView { ) method 
with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

with 

the event JCSystem. CLEAR ON DESELECT 


1- Appletl is triggered 

2- SystemException. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_RESET FileView object 

1 Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory {MEMORY_ 
TYPE_TRANSIENT_RESET) 

2- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_RESET) 

3- Applet calls method getTheFileView { ) 
with buffer[20] = {ADFl,...} 

bOffset= 
bLength= 16 
with the event 
JCSystem . CLEAR_ON_RESET 

4- Reset 


1 - No Exception shall be thrown 

2- No Exception shall be thrown 

3- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method 

length=JCSystem.getAvailableMemory {MEMORY_ 
TYPE_TRANSIENT_DESELECT) 

3- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR ON DESELECT) 

} 

4- Applet calls method getTheFileView { ) 
with buffer[20] = {adfI,...} 

bOffset= 

bLength= 16 

with event : 

JCSystem. CLEAR ON DESELECT 


1- Appletl is triggered 

2- No Exception shall be thrown 

3- No Exception shall be thrown 

4- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getTheFileView { ) with 
event different from 0,1,2 


1- 

SystemException.lLLEGAL_VALU 
E is thrown 




8 


NullPointerException 

Invoke the method getTheFileView { ) with 
buffer [20] = null 
bOffset= 
bLength= 16 

with event : 
1 - JCSystem. CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 




9 


ArraylndexOutOfBoundsException 

l-Envelope menu selection is sent to the 
UICC 

Invoke the method getTheFileView { ) with 

buffer[20] = {ADFI,...} 

bOffset= 5 

bLength= 16 

event = JCSystem. CLEAR_ON_RESET 

Invoke the method getTheFileView { ) with 

buffer[20] = {ADFI,...} 

bOffset= -1 

bLength= 16 

event = JCSystem. CLEAR ON RESET 


1- Appletl is triggered 

Shall be thrown 
ArraylndexOutOfBoundsException 

Shall be thrown 
ArraylndexOutOfBoundsException 




10 


SystemException.lLLEGAL_VALUE 

l-Envelope menu selection is sent to the 
UICC 

Invoke the method getTheFileView {) with 

buffer[20] = {ADFI,...} 

bOffset= 

bLength= 4 

event = JCSystem. CLEAR_ON_RESET 

Invoke the method getTheFileView { ) with 

buffer[20] = {ADFI,...} 

bOffset= 

bLength= 17 

event = JCSystem. CLEAR_ON_RESET 


1 - Appletl is triggered 

SystemException. ILLEGAL_VALU 
E shall be thrown 

SystemException. ILLEGAL_VALU 
E shall be thrown 
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5.1.4 Interface UlCCException 
5.1.4.1 Constructor 

Test Area Reference: Api_l_Uex_Coor. 

5.1 .4.1 .1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public UlCCException {short reason) 

throws UlCCException 

5.1.4.1.1.1 Normal execution 

• CRRNl: Construct an UlCCException with the specified reason. 

5.1.4.1.1.2 Parameter errors 
No requirements. 

5.1.4.1.1.3 Context errors 
No requirements. 

5.1.4.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.4.1.3 



Test suite files 

Test_Api_2_Uex_Coor.j ava. 
Api_2_Uex_Coor_ 1 .j ava. 
api_2_uex_coor.cap. 

Test Coverage 



CRR number 


Test case number 


N1 


1 



5.1.4.1.4 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


UlCCException with the specified reason 

{The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





5.1.4.2 Method throwit 

Test Area Reference: Api_l_Uex_Thit. 

5.1.4.2.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public static void throwit {short reason) 
throws UlCCException 
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5.1 .4.2.1 .1 Normal execution 

• CRRNl: Throws the JCRE owned instance of UICCException with the specified reason. 

• CRRN2: extends javacard.framework.CardRuntimeException. 



5.1.4.2.1.2 

No requirements. 

5.1.4.2.1.3 

No requirements. 

5.1.4.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.1.4.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Uex_Thit.j ava. 
Api_2_Uex_Thit_ 1 .j ava. 
api_2_uex_thit. cap . 

Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


4,5,6 



5.1.4.2.4 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of UICCException with 
the specified reason 


Reason = 




2 


Throws the JCRE instance of UICCException with 
the specified reason 


Reason = 1 




3 


Throws the JCRE instance of UICCException with 
the specified reason 


Reason = 0xA55A 




4 


UICCException extends 
javacard.frameworl<.CardRuntimeException 


Reason = 




5 


UICCException extends 
javacard.frameworl<.CardRuntimeException 


Reason = 1 




6 


UICCException extends 
javacard.frameworl<.CardRuntimeException 


Reason = 0xA55A 





5.1.4.3 Reason Codes 

This part contain only constant defined for the available reason code. No test of constants will be performed. 

5.1.5 Contexts 
5.1.5.1 Context tests 

Test Area Reference: Api_l_Cont 
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5.1.5.1.1 



Conformance requirement 



5.1.5.1.1.1 



Normal execution 



CRRNl: A file (EF, DF or ADF) can be accessed (selected, read, updated, deleted, deactivated, activated, 
increased, searched, resized) concurrently by different UlCC-based applications such as toolkit applications. 

CRRN2: A file (EF, DF or ADF) created by a File View can be accessed by other applications and vice versa. 

CRRN3: If a file is indicated as shareable (in the file descriptor byte in the FCP), then applications may 
perform authorized operations (selected, read, updated, deleted, deactivated, activated, increased, searched, 
resized, deleted) on the file independently of whether or not the file is the current file of any other application. 
A consequence is that if changes to a shareable file are permitted by the file's security conditions, then the file 
can be changed by one application while it is currently selected and being used by a second application. 

CRRN4: If a file is indicated as non-shareable and is the current file of one application, then another 
application cannot perform any operation on the file regardless of authorization. A consequence is that an 
application acquires exclusive access to a not-shareable file by successfully selecting it. Access by any other 
application, including an attempt to select the file, shall return an error indication. 

CRRN5: Concurrent access to a file by two executing instances of a single application is considered to be 
accessed by two different applications. 



5.1.5.1.1.2 

No requirements. 



Parameter errors 



5.1.5.1.1.3 

No requirements. 



Context errors 



5.1.5.1.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Api_ 1 _Cont.j ava. 
Api_l_Cont _l.java. 
api_l_cont.cap. 



5.1.5.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,9,10 


N2 


1,2,3,4,5,6,7,8,9, 10 


N3 


1,2,3,4,5,6,7,8,9, 10 


N4 


11, 12, 13, 14, 15, 16 


N5 


1,2,3,4,5,6,7,8,9, 10 
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5.1.5.1.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



1- Select DF telecom 

2- Trigger applet 

3- Applet gets object UICCFileViewl using 
getTheUICCView { ) 

4- Applet gets object UICCFileView2 using 
getTheUICCView ( ) 

5- Applet gets object ADFlFileViewl using 
getTheFileView { ) 

6- Applet gets object ADFlFileView2 using 
getTheFileView { ) 

7- Applet gets object UICCAdminFileViewl 
using getTheUICCAdminFileView {) 

8- Applet gets object UICCAdminFileView2 
using getTheUICCAdminFileView {) 

9- Applet gets object ADFlAdminFileViewl 
using getTheAdminFileView {) 

10- Applet gets object ADFlAdminFileView2 
using getTheAdminFileView {) 



Select and status 



1- UICCFileViewl. select {) DFtest, 
UICCFileViewl. select {) EFtahu, 

2- UICCFileViewl. select {) ADFl 



3- UI CCFileView2. select EFnicc, 

4- UICCFileView2. select ADFl 



5- ADFlFileViewl . select DFtelecom, 

6- ADFlFileViewl. select MF 



7- ADFlFileView2 . select {) DFtest, 
ADFlFileView2 . select { ) DFsubtest 

8- ADFlFileView2 .select {) MF 



9- UICCFileViewl. status {) 



10- UICCFileView2 . status { ) 



11- ADFlFileViewl. status {) 



12- ADFlFileView2 . status { ) 



13- Status 



UICCException.FILE_NOT_FOUN 
D is thrown 



UICCException.FILE_NOT_FOUN 
D is thrown 



UICCException.FILE_NOT_FOUN 
D is thrown 



UICCException.FILE_NOT_FOUN 
D is thrown 



9- FCP corresponding to DFtest 
(under IVIF) is returned 

10- FCP corresponding to IVIF is 
returned 

1 1 - FCP corresponding to 
DFtelecom (under ADF1) is 
returned 

12- FCP corresponding to 
DFsuB_TEST (under ADFl ) is 
returned 

Applet finalizes 



13- FCP corresponding to 
DF TELECOM (under MF) is 
returned 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Select SFI 








1- UICCFileViewl. select {) DFtest, 
UICCFileViewl. select {) EFtne with SFI 01, 


1 - No exception is thrown 






UICCFileViewl . deactivate { ) 








2- UICCFileViewl. select {) SFI 06 


2- 

UICCException.FILE_NOT_FOUN 
D is thrown 






3- UI CCFileView2. select {) DFtest, 








UICCFileView2. select {) EFtaru with SFI 03, 


3- No exception is thrown 






UICCFileView2.updateBinary{) 01 01 






4- UICCFileView2. select {) SFI 08 


4- 
UICCException.FILE_NOT_FOUN 






5- ADFlFileViewl. select {) DFtest, 


D is thrown 






ADFlFileViewl. select { ) EFckr with SFI 04, 








ADFlFileViewl . deactivate { ) 


5- No exception is thrown 






6- ADFlFileViewl. select {) SFI 06 








7- ADFlFileView2. select {) DFtest, 


6- 
UICCException.FILE_NOT_FOUN 






ADFlFileView2. select {) EFtarh with SFI 03, 


D is thrown 






ADFlFileView2 .updateBinary {) 02 02 








8- ADFlFileView2. select {) SFI 08 


7- No exception is thrown 






9- select DF test, select EFtkr 


8- 
UICCException.FILE_NOT_FOUN 






10- activate 


D is thrown 


1 0- SW=90 00 




11- select DF test, select EFtaru 

12- readBinary 


Applet finalizes 






13- updateBinary FF FF FF... 








14- select AID of ADFl, select DF test. 




12- Returns 01 01 




select EFcNR 








15- activate 








16- select EFtaru, 








17- readBinary 

18- updateBinary FF FF FF... 




1 5- SW=90 00 
17- Returns 02 02 


3 


ReadBinary and updateBinary 

1- Reset 

2- Trigger the applet 

3- UICCFileViewl. select {) DFtest, 
UICCFileViewl. select {) EFtaru, 
UICCFileViewl. updateBinary {) 01 01 01 01, 
offset 








4- UICCFileViewl .readBinary {) , offset 


3- No exception is thrown 






5- UICCFileView2. select {) DFtest, 


4- Returns 01 01 01 01 






UICCFileView2. select {) EFtaru, 








UICCFileView2. updateBinary {) 02 02, offset 








2 


5- No exception is thrown 






6- UICCFileView2.readBinary{) , offset 








7- ADFlFileViewl. select {) DFtest, 


6- Returns 01 01 02 02 






ADFlFileViewl. select {) EFtaru, 








ADFlFileViewl. updateBinary {) 03 03 03 03, 








offset 


7- No exception is thrown 






8- ADFlFileViewl .readBinary {) , offset 
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Id 


Description 


API Expectation 


APDU Expectation 




9- ADFlFileView2. select {) DFtest, 








ADFlFileView2 . select {) EFtaeu, 
ADFlFileView2 .updateBinary {) 04 04, offset 
2 


8- Returns 03 03 03 03 






10- ADFlFileView2 .readBinary {) , offset 


9- No exception is thrown 






11- select DF test, select EF taeu, 








readBinary 


1 0- Returns 03 03 04 04 






12- updateBinary FF FF FF... 


Applet finalizes 


11- Returns 01 01 02 02 




13- select AID of ADFl, select DF test. 








select EF taru, readBinary 








14- updateBinary FF FF FF... 




1 3- Returns 03 03 04 04 


4 


SearchRecord 

1- Reset 

2- Trigger the applet 








3- UICCFileViewl. select {) DFtest, 


3- returns 2 






UICCFileViewl. select {) EFldpc, 








UICCFileViewl. SearchRecord {) 22 22 22 22 








22 22 22 22 22 22 








4- UICCFileViewl .updateRecordO current 33 


4- No exception is thrown 






33 33 33 33 33 33 33 33 33 








5- UICCFileView2. select {) DFtest, 
UICCFileView2. select {) EFlupc, 


5- 
UICCException.RECORD_NOT_F 






UICCFileView2 . readRecordO current 


OUND is thrown 






6- UICCFileView2. SearchRecord {) 22 22 22 


6- returns 






22 22 22 22 22 22 22, 


7- returns 2 






7- UICCFileView2. SearchRecord {) 33 33 33 








33 33 33 33 33 33 33 


8- returns 






8- ADFlFileViewl. select {) DFtest, 








ADFlFileViewl. select {) EFldpc, 








ADFlFileViewl. SearchRecord {) 33 33 33 33 








33 33 33 33 33 33 








9- ADFlFileViewl. SearchRecord {) 22 22 22 


9- returns 2 






22 22 22 22 22 22 22 








10- ADFlFileViewl .updateRecord { ) current 


1 0- No exception is thrown 






11 11 11 11 11 11 11 11 11 11 








11- ADFlFileView2. select {) DFtest, 


11- returns 






ADFlFileView2. select {) EFldpc, 








ADFlFileView2. SearchRecord 22 22 22 22 








22 22 22 22 22 22 


12- returns 1 and 2 






12- ADFlFileView2. SearchRecord {) 11 11 11 
11 11 11 11 11 11 11 


Applet finalizes 






13- select DF test, select EFldpc, readRecord 
01 




13- returns 11 11111111 
11 11 11 11 11 




14- readRecord 02 








15- updateRecord 01, 11 11 11 11 11 11 11 
11 11 11 




14- returns 33 33 33 33 33 
33 33 33 33 33 




16- updateRecord 02, 22 22 22 22 22 22 22 








22 22 22 








17- select AID of ADFl, select DF test. 








select EFldpc, readRecord 01 




1 7- returns 11 11 11 11 11 
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Id 



Description 



API Expectation 



APDU Expectation 



18- readRecord 02 

19- updateRecord 01 11 11 11 11 11 11 11 
11 11 11 

20- updateRecord 02 22 22 22 22 22 22 22 
22 22 22 



11 11 11 11 11 

1 8- returns 1111111111 
11 11 11 11 11 



readRecord and updateRecord 

1- Reset 

2- Trigger the applet 



3- UICCFileViewl. select {) DFtest, 
UICCFileViewl. select {) EFlaru, 
UICCFileViewl. updateRecord {) 66 66 66 66, 
next 

4- UICCFileViewl . readRecord {) , current 

5- UICCFileViewl.readRecordO , next 

6- UICCFileView2 .select {) DFtest, 
UICCFileView2 .select {) EFlarh, 
UICCFileView2 . readRecord { ) , current 

7- UICCFileView2 .updateRecord {) BB BB BB 
BB, record 2 

8- UICCFileView2 .readRecordO , next 

9- UICCFileView2 .readRecordO , next 

10- ADFlFileViewl . select {) DFtest, 
ADFlFileViewl. select {) EFlaru, 
ADFlFileViewl .updateRecord {) 44 44 44 44, 
next 

11- ADFlFileViewl . readRecord {) , current 

12- ADFlFileViewl .readRecordO , next 

13- ADFlFileView2 .select DFtest, 
ADFlFileView2 . select EFlaru, 
ADFlFileView2 . readRecord { ) , current 

14- ADFlFileView2 .updateRecord 99 99 99 
99, record 2 

15- ADFlFileView2 .readRecordO , next 

16- ADFlFileView2 .readRecordO , next 



17- select DF TEST, 
readRecord next 



select EF 



18- readRecord next 

19- updateRecord record 1, 55 55 55 55 

20- updateRecord record 2, AA AA AA AA 

21- select AID of ADFl, select DF test, 
select EFlaru, readRecord next 

22- readRecord next 

23- updateRecord record 1, 55 55 55 55 

24- updateRecord record 2, AA AA AA AA 



3- No exception is thrown 



4- returns 66 66 66 66 

5- returns AA AA AA AA 
6- 

UICCException.RECORD_NOT_F 
OUND is tlirown 

7- No exception is thrown 

8- returns 66 66 66 66 

9- returns BB BB BB BB 

1 0- No exception is thrown 



1 1 - returns 44 44 44 44 
1 2- returns AA AA AA AA 

13- 

UICCException.RECORD_NOT_F 
OUND is thrown 

14- No exception is thrown 

1 5- returns 44 44 44 44 
16- returns 99 99 99 99 
Applet finalizes 



17- returns 66 66 66 66 
18- returns BB BB BB BB 

21 - returns 44 44 44 44 
22- returns 99 99 99 99 
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Id 



Description 



API Expectation 



APDU Expectation 



ActivateFlle and deactivateFlle 

1- Reset 

2- Trigger the applet 

3- UICCFileViewl. select {) DFtest, 
UICCFileViewl. select {) EFtmj, 
UICCFileViewl . deactivate { ) 

4- UICCFileView2 .select {) DFtest, 
UICCFileView2 .select {) EFtnd, 
UICCFileView2 . readBinary { ) 

5- UICCFileView2 .activate {) , 
UICCFileView2 . readBinary { ) 

6- UICCFileView2 .deactivate {) 

7- ADFlFileViewl . select {) DFtest, 
ADFlFileViewl. select {) EFtnd, 
ADFlFileViewl . readBinary { ) 

8- ADFlFileViewl. deactivate {) 

9- ADFlFileView2 . select {) DFtest, 
ADFlFileView2 . select {) EFtnd, 
ADFlFileView2 . readBinary { ) 

10- ADFlFileView2 .activate {) , 
ADFlFileView2 . readBinary { ) 

11- select DF test/ select EFtnd 

12- activate 

13- select AID of ADFl, select DF test, 
select EFtnd 



3- No exception is thrown 



UICCException.REF_DATA_INVAL 
IDATED is thrown 

5- returns 55 55 55 

6- No exception is thrown 

7- returns 55 55 55 



8- No exception is thrown 



UICCException.REF_DATA_INVAL 
IDATED is thrown 



1 0- returns 55 55 55 
Applet finalizes 



1 1 - SW = 62 83 
12-SW = 90 00 
13-SW = 90 00 



Increase 



Reset 



2- Trigger the applet 

3- UICCFileViewl. select {) DFtest, 
UICCFileViewl. select {) EFcaeu, 
UICCFileViewl. updateRecordO 00, 
previous 

UICCFileViewl. updateRecordO 00, 
previous 

4- UICCFileViewl. increase {) , 00 00 01 

5- UICCFileViewl . readRecord {) , current 

6- UICCFileViewl . readRecord {) , previous 

7- UICCFileView2 .select {) DFtest, 
UICCFileView2 .select {) EFcaeu, 
UICCFileView2 . readRecord { ) , current 

8- UICCFileView2 .increase {), 00 00 01 

9- UICCFileView2 .readRecordO , current 

10- UICCFileView2 . readRecord {) , previous 

11- ADFlFileViewl. select {) DFtest, 
ADFlFileViewl . select {) EFcaeu, 
ADFlFileViewl . readRecord { ) , current 

12- ADFlFileViewl .updateRecordO 00, 
previous 

ADFlFileViewl .updateRecordO 00 00 00, 
previous 

13- ADFlFileViewl . increase , 00 00 02 

14- ADFlFileViewl . readRecord , current 

15- ADFlFileViewl . readRecord , previous 



3- No exception is thrown 



4- resp[] = 00 00 01 

5- returns 00 00 01 

6- returns 00 00 00 
7- 

UICCException.RECORD_NOT_F 
OUND is thrown 

8- resp[] = 00 00 02 

9- returns 00 00 02 
10- returns 00 00 01 

11- 

UICCException.RECORD_NOT_F 
OUND is thrown 

1 2- No exception is thrown 



1 3- resp[] = 00 00 02 

14- returns 00 00 02 
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Id 


Description 


API Expectation 


APDU Expectation 






1 5- returns 00 GO GO 






16- ADFlFileView2. select {) DFtest, 


16- 






ADFlFileView2. select {) EFcaEu, 
ADFlFileView2 . readRecord { ) , current 


UICCException.RECORD_NOT_F 
OUND is thrown 






17- ADFlFileView2. increase {), 00 00 02 


1 7- resp[] = GG GG 04 






18- ADFlFileView2 .readRecordO , current 








19- ADFlFileView2 .readRecordO , previous 


1 8- returns 00 GO G4 






20- select DF test, select EFcaeu, readRecord 
current 


1 9- returns 00 GO G2 
Applet finalizes 


20- SW = 6A 83 




21- readRecord previous 

22- readRecord previous 




21- returns 00 GO G1 

22- returns 00 00 02 




23- updateRecord previous AA AA AA 








24- updateRecord previous 55 55 55 




23- SW = 90 GO 




25- select AID of ADFl, select DF test, 
select EFcARH, readRecord current 




24- SW = 90 GO 

25- SW = 6A 83 




26- readRecord previous 








27- readRecord previous 




26- returns 00 GO 02 

27- returns 00 GO 04 




28- updateRecord previous AA AA AA 








29- updateRecord previous 5 5 5 5 5 5 




28- SW = 90 GO 

29- SW = 90 GO 


8 


CreateFile EF 

1- Reset 

2- Trigger the applet 








3- UICCAdminFileViewl. select {) DFtest, 
UICCAdminFileViewl. select {) 6F 29 


3- 

UICCException.FILE_NOT_FOUN 
D is thrown 






4- UICCAdminFileViewl. create {) 6F 29 


4- No exception is thrown 






5- UICCAdminFileViewl. select {) 6F 29 


5- No exception is thrown 






6- UICCAdminFileView2. select {) DFtest, 
UICCAdminFileView2. select {) 6F 29 


6- No exception is thrown 

7- 

UICCException.FILE_NOT_FOUN 






7- UICCAdminFileView2. select {) 6F 2A 








D is thrown 






8- UICCAdminFileView2. create {) 6F 2A 


8- No exception is thrown 






9- UICCAdminFileViewl. select {) 6F 2A 

10- UICCAdminFileViewl. select {) 6F 29 


9- No exception is thrown 

1 0- No exception is thrown 
11- 
UICCException.FILE_NOT_FOUN 












11- ADFlAdminFileViewl. select {) DFtest, 


D is thrown 






ADFlAdminFileViewl. select {) 6F 29 








12- ADFlAdminFileViewl. create {) 6F 29 


12- No exception is thrown 

1 3- No exception is thrown 






13- ADFlAdminFileViewl. select {) 6F 29 






14- ADFlAdminFileView2 . select {) DFtest, 
ADFlAdminFileView2. select {) 6F 29 


14- No exception is thrown 






15- ADFlAdminFileView2. select {) 6F 2A 


15- 

UICCException.FILE_NOT_FOUN 
D is thrown 






16- ADFlAdminFileView2. create {) 6F 2A 


16- No exception is thrown 






17- ADFlAdminFileViewl. select {) 6F 2A 

18- ADFlAdminFileViewl. select {) 6F 29 


17- No exception is thrown 

18- No exception is thrown 






21- select DF test, select 6F 29 


Applet finalizes 


21 - SW = 90 GO 




22- select 6F 2A 




22- SW = 90 GO 




23- select AID of ADFl, select DF test, 
select 6F 29 




23- SW = 90 GO 
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Id 



Description 



API Expectation 



APDU Expectation 



24- select 6F 2A 



24- SW = 90 00 



CreateFile DF 



2- Trigger the applet 

3- UICCAdminFileViewl. select {) DFtest, 
UICCAdminFileViewl. select {) 5F 01 

4- UICCAdminFileViewl. create {) 5F 01 

5- UICCAdminFileViewl. select {) 5F 01 

6- UICCAdminFileView2 .select {) DFtest, 
UICCAdminFileView2 .select {) 5F 01 

7- UICCAdminFileView2 .select {) 5F 02 



8- UICCAdminFileView2 .create {) 5F 02 

9- UICCAdminFileViewl. select {) 5F 02 

10- UICCAdminFileViewl. select {) 5F 01 



11- 

ADFlAdminFileViewl . select {) 5F 01 

12- ADFlAdminFileViewl .create {) 5F 01 

13- ADFlAdminFileViewl . select {) 5F 01 



14- ADFlAdminFileView2 .select {) 5F 01 

15- ADFlAdminFileView2 .select {) 5F 02 



16- ADFlAdminFileView2 .create {) 5F 02 

17- ADFlAdminFileViewl. select {) 5F 02 

18- ADFlAdminFileViewl. select {) 5F 01 



21- select 5F 01 

22- select 5F 02 



23- select AID of ADFl, select 5F 01 

24- select 5F 02 



UICCException.FILE_NOT_FOUN 
D is thrown 

4- No exception is thrown 

5- No exception is thrown 



6- No exception is thrown 
7- 

UICCException.FILE_NOT_FOUN 
D is thrown 

8- No exception is thrown 

9- No exception is thrown 

10- No exception is thrown 



11- 

UICCException.FILE_NOT_FOUN 
D is thrown 

1 2- No exception is thrown 

13- No exception is thrown 



14- No exception is thrown 
15- 

UICCException.FILE_NOT_FOUN 
D is thrown 

1 6- No exception is thrown 

17- No exception is thrown 

18- No exception is thrown 

Applet finalizes 



21 - SW = 90 00 

22- SW = 90 00 

23- SW = 90 00 

24- SW = 90 00 
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10 


ResizeFile 

1- Reset 

2- Trigger the applet 

3- UICCAdminFileViewl. select {) DFtest, 








UICCAdminFileViewl . select { ) EFtdac, 


3- 






UICCAdminFileViewl .readBinaryO , length 06 


UlCCException.OUT OF FILE BO 
UNDARIES is thrown 






4- UICCAdminFileViewl.resizeO ,add 3 bytes 








UICCAdminFileViewl .readBinaryO , length 06 








5- UICCAdminFileView2. select {) DFtest, 


4- returns 00 00 00 FF FF FF 






UICCAdminFileView2 . select { ) EFtdac, 








UICCAdminFileView2 .readBinaryO , length 06 








6- UICCAdminFileViewl.resizeO, remove 2 


5- returns 00 00 00 FF FF FF 






bytes 


6- No exception is thrown 






7- ADFlAdminFileViewl . select DFtest, 








ADFlAdminFileViewl . select { ) EFlnd, 








ADFlAdminFileViewl . readRecord { ) , record 4 


7- 
UICCException.RECORD_NOT_F 






8- ADFlAdminFileViewl .resize , add 2 


OUND is thrown 






records 








ADFlAdminFileViewl . readRecord {), record 4 








9- ADFlAdminFileVie2 . select DFtest, 


8- returns FF FF FF FF 






ADFlAdminFileView2 . select { ) EFlnd, 








ADFlAdminFileView2 . readRecord {), record 4 








10- ADFlAdminFileView2 . resize , remove 1 


9- returns FF FF FF FF 






record 








11- select DF test, select EFtdac, readBinary 
length 06 


1 0- No exception is thrown 
Applet finalizes 


11- R-APDU = 00 00 00 FF 
90 00 or 




12- readBinary length 04 




62 82 or 
67 00 




13- resize, remove 1 byte 








14- select AID of ADFl, select DF test, 
select EFlnd, readRecord record 4 




12- returns 00 00 00 FF 




15- readRecord record 3 




1 3- SW = 90 00 




16- resize, remove 1 record 




14-SW = 6A83 

15- returns FFFFFFFF 

1 6- SW = 90 00 


11 


Non-Shareable files (UlCCFileView - 
UlCCFileView) 

1- Reset 

2- Trigger the applet 








3- UICCFileViewl. select DFtest, 
UICCFileViewl. select EFnosh 


3- No exception is thrown 






4- UICCFileView2. select DFtest, 


4- 






UICCFileView2 . select { ) EFnosh 


UICCException.lNTERNAL_ERRO 
R is thrown or 






5- UICCFileViewl. select DFtest 


UlCCException.FILE NOT FOUN 
D 






6- UICCFileView2. select EFnosh 


5- No exception is thrown 

6- No exception is thrown 
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12 


Non-shareable files (FlleVlew - FlleView) 

1- Reset 

2- Trigger the applet 

3- ADFlFileViewl. select {) DFtest, 
ADFlFileViewl . select { ) EFnosh 

4- ADFlFileView2 . select {) DFtest, 
ADFlFileView2 . select { ) EFhosh 

5- ADFlFileViewl. select {) DFtest 

6- ADFlFileView2. select {) EFnosh 


3- No exception is thrown 

4- 

UICCException.lNTERNAL_ERRO 
R is thrown or 

UlCCException.FILE NOT FOUN 
D 

5- No exception is thrown 

6- No exception is thrown 




13 


Non-Shareable files (UlCCFIIeView - MP) 

1- Trigger the applet 

2- UICCFileViewl. select {) DFtest, 
UICCFileViewl . select { ) EFnosh 

4- Select DFtest, select EFnosh 

5- Fetch and terminal response 


2- No exception is thrown 

3- Applet sends a display text 


4- SW = 69 85 


14 


Non-shareable files (FlleVlew - ADF) 

1- Trigger the applet 

2- ADFlFileViewl. select {) DFtest, 
ADFlFileViewl . select { ) EFnosh 

4- Select AID of ADFl, select DFtest, select 
EFnosh 

5- Fetch and terminal response 


2- No exception is thrown 

3- Applet sends a display text 


4- SW = 69 85 


15 


Non-Shareable files (MF - UlCCFIIeView) 

1- Reset 

2- Select DFtest, select EFnosh 

3- Trigger the applet 

4- UICCFileViewl. select {) DFtest, 
UICCFileViewl . select { ) EFnosh 


4- 

UICCException.lNTERNAL_ERRO 
R is thrown or 

UlCCException.FILE NOT FOUN 
D 


2- SW = 90 00 
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16 


Non-shareable files (ADF - FileView) 

1- Reset 








2- Select AID of ADFl, select DFtest, select 
EFnosh 




2- SW = 90 00 




3- Trigger the applet 








4- ADFlFileViewl. select {) DFtest, 


4- 






ADFlFileViewl . select { ) EFnosh 


UICCException.lNTERNAL_ERRO 
R is thrown or 

UlCCException.FILE NOT FOUN 
D 




17 


Terminated EF/DF 

1- Reset 

2- Trigger the applet 








3- UICCAdminFileViewl. select {) DFtest, 
UICCAdminFileViewl . select { ) EFteem 


3- No exception is thrown 






4- UICCAdminFileViewl. select {) DFtest, 








UICCAdminFileViewl . select { ) DFteem 


4- No exception is thrown 
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5.2 Package uicc.toolkit 



5.2.1 Interface EditHandler 

Tests are done in inheriting interfaces EnvelopeResponseHandler and ProactiveHandler. 

5.2.2 Interface EnvelopeHandler 
5.2.2.1 Method getltem Identifier 

Test Area Reference: Api_2_Enh_Giid 

5.2.2.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier { ) 

throws ToolkitException 

5.2.2.1.1.1 Normal execution 

• CRRNl:The method shall return the item identifier byte value. 

• CRRN2:The item identifier byte value returned shall be from the first Item Identifier TLV element. 

• CRRN3: If the element is available it becomes the TLV selected. 

• CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination 
of their processTooMt method if the EnvelopeHandler is available. 



5.2.2.1.1.2 

No requirements. 

5.2.2.1.1.3 



Parameter errors 



Context errors 



• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if the item identifier TLV is 
not present. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if the item identifier byte 
is missing in the Item Identifier Comprehension TLV. 



5.2.2.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.2.1.3 



Test area files 

Test_Api_2_Enh_Giid.j ava. 
Api_2_Enh_Giid_ Lj ava. 
api_2_enh_giid.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


2,3 


N3 


4 


N4 


6 


C1 


5 


C2 


7 
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5.2.2.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope Menu Selection with item 
identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope Menu Selection with two item 
identifier TLV with first value 02 and 
second 01 


Returns 02 




3 


Send envelope Menu Selection with two item 
identifier TLV with first value 04 and 
second 01, call twice the method 
getltemldentif ier { ) 


Returns 04 
Returns 04 




4 


Send envelope Menu Selection with item 
identifier TLV and value of 66. FindTLVO 
with TAG 02. getltemldentif ier {) and then 
getValueByte {) with offset 


getltemldentifier{)=getValueByte() 




5 


Send unrecognized envelope without item 
identifier TLV and getltemldentif ier { ) 


ToolkitException.UNAVAILABLE E 
LEMENT 




6 


Send Envelope Menu Selection with item 
identifier TLV (66), send proactive 
command. Then getltemldentif ier { ) 


Returns 66 




7 


Send Unrecognized Envelope with item 
identifier TLV but without item number 


ToolkitException.OUT OF TLV B 
OUNDARIES 





5.2.2.2 Method getLength 

Test Area Reference: Api_2_Enh_Glen. 

5.2.2.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength {) 

throws ToolkitException 

5.2.2.2.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.2.2.1 .2 Parameter errors 
No requirements. 

5.2.2.2.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.2.2 Test area files 

Specific triggering: Unrecognized envelope: 
Test Source: Test_Api_2_Enh_Glen.java. 
Test Applet: Api_2_Enh_Glen_l.java. 

Cap File: api_2_enh_glen.cap. 



5.2.2.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


C1 


Not testable 
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5.2.2.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send an Unrecognized Envelope with BER length 
of 0x31 


Result of getLengthQ is 0x0031 




2 


Send an Unrecognized Envelope with BER length 
of 0x7F 


Result of getLengthQ is 0x007Fh 




3 


Send an Unrecognized Envelope with BER length 
of 81 80 


Result of getLengthQ is OxOOSOh 




4 


Send an Unrecognized Envelope with BER length 
of 81 FC 


Result of getLengthQ is OxOOFCh 





5.2.2.3 Method copy 

Test Area Reference: Api_2_Enh_Copy. 

5.2.2.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy{byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.2.3.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.2.3.1 .2 Parameter errors 

• CRRPl: if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is greater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.2.3.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.3.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Copy.java. 
Test Applet: Api_2_Enh_Copy_l.java. 

Cap File: api_2_enh_copy.cap. 
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5.2.2.3.4 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Not testable 



5.2.2.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




3 


dstOffset < 

copy {) 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


dstLength > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

copy { ) 

DstBuffer.length = 5 
DstOffset = 3 
DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

copy { ) 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the Comprehension TLV 
list 

copy { ) 

DstBuffer.length = 48 
DstOffset = 
DstLength = 48 


ToolkitException.OUT OF TLV BO 
UNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy { ) 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copyO is 0X0047 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy { ) 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copyO is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy { ) 

dstBuffer.length = 252 
dstOffset = 3 
dstLength = 252 


Result of copyO is OXOOFF 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

copy { ) 

dstBuffer.length = 260 
dstOffset = 257 
dstLength = 3 


Result of copyO is 0X0104 




15 


Compare the whole buffer 


Result of arrayCompareO is 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Successful call, copy() with length =0 

dstBuffer. length = 2S0 
dstOffset = 260 
dstLength = 


Result of copyO is 0x1 04 





5.2.2.4 Method findTLV 

Test Area Reference: Api_2_Enh_Find. 

5.2.2.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV {byte tag, 

byte occurrence) 
throws ToolkitException 

5.2.2.4.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.2.4.1 .2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.2.4.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.4.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Find.java. 
Test Applet: Api_2_Enh_Find_l.java. 

Cap File: api_2_enh_find.cap. 
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5.2.2.4.3 



Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7, 8, 9 


N5 


12, 13 


P1 


1 


C1 


Not testable 



5.2.2.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Trigger the applet with Unrecognized Envelope 

including: 

Tag 82, tag 86, tag 8B, tag 02 and tag 04 






1 


Invalid input parameter 

findTLVO 
Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 


SearchlstTLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 0x02 




4 


Search 2nd TLV 

findTLVO 
Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 0x05h 




6 


Select a TLV (tag 02h) 
Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Search a tag with wrong occurrence 

findTLVO 
Tag = 02h 
Occurrence = 3 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 86h 

findTLVO 
Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 
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5.2.2.5 Method getValueLength 

Test Area Reference: Api_2_Enh_Gvle. 

5.2.2.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getValueLength { ) 

throws ToolkitException 



5.2.2.5.1.1 



Normal execution 



• CRRNl : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.2.5.1.2 

No requirements. 

5.2.2.5.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.5.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test source: Test_Api_2_Enh_Gvle.java. 

Test Applet: Api_2_Enh_Gvle_l.java. 

Cap File: api_2_enh_gvle.cap. 



5.2.2.5.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4 


C1 


Not testable 


C2 


1 



5.2.2.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized envelope with TLV: Tag 02, 
length 02, Tag 06, length 05, Tag OB, length 24, 
Tag 33, Length C8 






1 


getValueLengthO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 

getValueLength { ) 


Result is 0X0002 




3 


Search TLV OBh 

getValueLength { ) 


Result is 0X0024 




4 


Search TLV 33h 

getValueLength { ) 


Result is 0X00C8 
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5.2.2.6 Method getValueByte 

Test Area Reference: Api_2_Enh_Gvby. 

5.2.2.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte {short valueOffset) 
throws ToolkitException 



5.2.2.6.1.1 



Normal execution 



• CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 

(1 byte). 



5.2.2.6.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.6.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.6.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Gvby.java. 
Test Applet: Api_2_Enh_Gvby_l.java. 

Cap File: api_2_enh_gvby.cap. 



5.2.2.6.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Not testable 


C2 


1 



5.2.2.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized envelope with TLV: Tag 02, 
length 02, value 83 81 , Tag 06, length 06, Tag OB, 
length 21, Tag 33, Length C8 Value 01 02 ... 






1 


getValueByte (0) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 

getValueByte (2) 






ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueByte (1) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 83h (Source) 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Search TLV 33h 








getValueByte {7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte (80) 


Result is 0x81 




7 


getValueByte {7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte {C7) 


Result is 0xC8 





5.2.2.7 Method copyValue 

Test Area Reference: Api_2_Enh_Cpyv. 



5.2.2.7.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue {short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.2.7.1.1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.2.7.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.7.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.7.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Cpyv.java. 
Test Applet: Api_2_Enh_Cpyv_Ljava. 

Cap File: api_2_enh_cpyv.cap. 
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5.2.2.7.3 



Test coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Not testable 


C2 


11 



5.2.2.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset > dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

copyValue { ) 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

copyValue { ) 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > TLV length 

copyValue { ) 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

copyValue { ) 
valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Search TLV 01 h 








copyValue { ) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown on the 
copyValueO method call. 




12 


Search TLV 06h 








Successful call 

copyValue { ) 
valueOffset = 
dstBuffer. length = 6 
dstOffset = 
dstLength = 6 


Result of copyValueO is 0x0006 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue { ) 
valueOffset = 1 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyValueO is 0x0007 




15 


Compare buffer 

buffer = 
55 55 55 11 22 
33 44 55 55 55 
55 55 55 55 55 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





5.2.2.8 Method compareValue 

Test Area Reference: Api_2_Enh_Cprv. 

5.2.2.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue {short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.2.8.1.1 Normal execution 

Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 
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5.2.2.8.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.2.8.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Cprv.java. 
Test Applet: Api_2_Enh_Cprv_Ljava. 

Cap File: api_2_enh_cprv.cap. 



5.2.2.8.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13, 14, 17 


N3 


16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Not testable 


C2 


11 



5.2.2.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








compareValue { ) with a null compareBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue { ) 
compareBuffer. length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue { ) 
compareBuffer. length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




7 


Search TLV 06h 








valueOffset > TLV Length 

compareValue { ) 
valueOffset = 6 
compareBuffer. length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

compareValue { ) 
valueOffset = -1 
compareBuffer. length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > TLV length 

compareValue { ) 
valueOffset = 
compareBuffer. length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > TLV length 

compareValue { ) 
valueOffset = 2 
compareBuffer. length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 


Result is TLV NOT FOUND 






compareValue { ) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Search TLV 06h 








Initialize compareBuffer 

compareBuffer = 
81 11 22 33 44 F5 








Compare buffers 

compareValue { ) 
valueOffset = 
compareOffset = 
compareLength = 6 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
7F 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








Compare buffers 

compareValue { ) 
valueOffset = 1 
compareOffset = 4 
compareLength = 5 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 10 23 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1-1 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Initialize compareBuffer 

compareBuf f er = 

55 55 55 81 12 21 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareValue() with length=o 

CompareBuf fer. length = 15 
CompareOf f set = 15 
CompareLength = 


Result of compareValueO is 





5.2.2.9 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: Api_2_Enh_Facyb_Bs. 

5.2.2.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue {byte tag, 

byte [] dstBuffer, 
short dstOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.2.9.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.2.9.1 .2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.2.9.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.9.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facyb_Bs.java. 
Test Applet: Api_2_Enh_Facyb_Bs_Ljava. 

Cap File: api_2_enh_facyb_bs.cap. 
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5.2.2.9.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


6,7 


N3 


8, 10, 12 


N4 


14, 15, 16, 17 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Not testable 



5.2.2.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


FindAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

f indAndCopyValue { ) 
tag = 06h 

dstBuffer.length = 06 
dstOffset = 06 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length = 06 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

f indAndCopyValue { ) 
dstBuffer.length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

f IndAndCopyValue { ) 
DstBuffer.length = 06 
DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCopyValueQ 

tag = 03h 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Successful call 

f IndAndCopyValue { ) 
Tag = 06h 

DstBuffer.length = 06 
DstOffset = 


Result of findAndCopyValue () is 
0006 




9 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




10 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 
dstBuffer.length = 12 
dstOffset = 2 


Result of findAndCopyValue () is 
0008 




11 


Compare buffer 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


Result is OOh 




12 


Successful call 

f IndAndCopyValue { ) 
tag = 02h 

dstBuffer.length = 2 
dstOffset = 


Result of findAndCopyValue () is 
0002 




13 


Compare buffer 

buffer = 83 81 


Result is OOh 





ETSI 



Release 6 



129 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


14 


Successful call (with tag 82h) 

f indAndCopyValue { ) 
tag = 82h 

dstBuffer. length = 02 
dstOffset = 


Result of findAndCopyValue () is 
0002 




15 


Compare buffer 

buffer = 83 81 


Result is OOh 




16 


Successful call (with tag B3h) 

f IndAndCopyValue { ) 
tag = B3h 

dstBuffer. length = C4 
dstOffset = 


Result of findAndCopyValue () is 
00C4 




17 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 





5.2.2.1 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: Api_2_Enh_Facybs_Bss. 

5.2.2.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short findAndCopyValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.2.10.1.1 



Normal execution 



• CRRNl : looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.2.10.1.2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.2.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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5.2.2.10.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facybs_Bss.java. 
Test Applet: Api_2_Enh_Facybs_Bss_l.java. 

Cap File: api_2_enh_facybs_bss.cap. 



5.2.2.10.3 



Test coverage 



CRR number 


Test case number 


N1 


14, 15, 17, 19,20 


N2 


11, 12 


N3 


13, 15, 17, 19,25 


N4 


21,22,23,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


26 


C1 


Not testable 



5.2.2.10.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

f IndAndCopyValue { ) 

tag = 06h, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 5 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

f IndAndCopyValue { ) 

tag = 06h, occurrence = 1 

valueOffset = 6 

dstBuffer.length = 15 

dstOffset = 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


valueOffset < 

f IndAndCopyValue { ) 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength! > Value length 

f IndAndCopyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 2 
dstBuffer. length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Select a TLV (tag 02h) 








findAndCopyValueQ 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




12 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown. 




13 


Successful call 

f IndAndCopyValue { ) 

tag = 06h, occurrence = 1 

valueOffset = 

dstBuffer. length = 06 

dstOffset = 

dstLength = 06 


Result of findAndCopyValueO is 6 




14 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




15 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 

tag = 06h, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 12 

dstOffset = 3 

dstLength = 04 


Result of findAndCopyValue () is 
0007 




16 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




17 


Successful call 

f IndAndCopyValue { ) 

tag = 02h, occurrence = 1 

valueOffset = 

dstBuffer. length = 12 

dstOffset = 

dstLength = 2 


Result of findAndCopyValueO is 
0002 




18 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 




19 


Successful call 

f IndAndCopyValue { ) 

tag = 02h, occurrence = 2 

valueOffset = 

dstBuffer. length = 12 

dstOffset = 

dstLength = 2 


Result of findAndCopyValueO is 
0002 




20 


Compare buffer 

buffer = 22 44 55 ... 55 


Result is OOh 




21 


Successful call (with tag 82h) 

f IndAndCopyValue { ) 
tag = 82h 
occurrence = 1 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




22 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


Successful call (with tag 82h) 

f IndAndCopyValue { ) 
tag = 82h 
occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




24 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 




25 


Successful call, findAndCopyValue() with 
length =0 

DstBuffer. length = 12 
dstOffset = 12 
dstLength = 


Result of findAndCopyValue () is 
12 




26 


Invalid parameter 

f IndAndCopyValue { ) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 





5.2.2.1 1 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 

compareOffset) 

Test Area Reference: Api_2_Enh_Facrb_Bs. 

5.2.2.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.2.11.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -1 . 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.2.11.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.2.11.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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5.2.2.11.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facrb_Bs.java. 
Test Applet: Api_2_Enh_Facrb_Bs_l.java. 

Cap File: api_2_enh_facrb_bs.cap. 



5.2.2.11.3 



Test coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


9 


N3 


8, 12, 13 


N4 


11, 15 


N5 


10, 14 


N6 


16, 17 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Not testable 



5.2.2.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length = 12 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








Compare buffers 

f IndAndCompareValue { ) 
tag = 06h 
compareOffset = 


Result is OOh 




9 


Verify current TLV 

getValueLength { ) 


Result is 06 




10 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




12 


Initialize compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 

f indAndCompareValue { ) 
compareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOf f set = 2 


Result is OOh 




14 


Initialize compareBuffer 

compareBuffer = 

55 55 83 80 55 55 55 55 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOf f set = 2 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOf f set = 2 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

f IndAndCompareValue { ) 
tag = 02h 

compareBuffer. length = 12 
compareOf f set = 


Result is OOh 




17 


Initialize compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

f IndAndCompareValue { ) 
Tag = B3h 

CompareBuffer. length = C4 
CompareOf f set = 


Result is OOh 





5.2.2.12 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: Api_2_Enh_Facrbbs_Bss. 



5.2.2.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f IndAndCompareValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 
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5.2.2.12.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV Hst and compare its value with a 
buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned 

• CRRN6: The search method is comprehension required flag independent. 

5.2.2.12.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException 
shall be thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.2.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.2.12.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Facrbbs_Bss.java. 
Test Applet: Api_2_Enh_Facrbbs_Bss_Ljava. 

Cap File: api_2_enh_facrbbs_bss.cap. 



5.2.2.12.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 13 


N2 


15 


N3 


14, 18,21,22,26 


N4 


17, 19,23 


N5 


16,20 


N6 


24,25 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


P4 


11 


CI 


Not testable 
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5.2.2.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized Envelope with TLV: Tag 

02, Value 83 81 , Tag 06, Value 81 1 1 22 33 44 

F5, Tag 02 Value 22 44 Tag 33, Length C4 

Value 01 02... 






1 


findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 6 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length = 6 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

f IndAndCompareValue { ) 
tag = 06h, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue { ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

f IndAndCompareValue { ) 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

f IndAndCompareValue { ) 
valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue { ) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




12 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




13 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








findAndCompareValueQ 

tag = 06h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




15 


Verify current TLV 

getValueLength { ) 


Result is 0006 




16 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




18 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 4 


Result is OOh 




19 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




20 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 

22 44 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




23 


Initialize compareBuffer 

compareBuffer = 

22 45 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is -1 




24 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

f IndAndCompareValue { ) 
tag = 02h, occurrence = 1 
valueOffset = 
compareBuffer. length = 12 
compareOf f set = 
compareLength = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


25 


Initialize compareBuffer 

compareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

f IndAndCompareValue { ) 
tag = B3h, occurrence = 1 
valueOffset = 
compareBuffer. length = 0C4 
compareOf f set = 
compareLength = 0C4 


Result is OOh 




26 


Successful call, findAndCompareValueQ with 
length =0 

DstBuffer. length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValueQ 
is OOh 





5.2.2.13 Method getCapacity 

Test Area Reference: Api_2_Enh_Gcap. 

5.2.2.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity { ) 

5.2.2.13.1.1 Normal execution 

• CRRNl : The method shall return the maximum size of the Comprehension TLV list managed by the handler. 

5.2.2.13.1.2 Parameter errors 
No requirements 

5.2.2.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 



5.2.2.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.2.13.3 



Test area files 

Test_Api_2_Enh_Gcap.java. 
Api_2_Enh_Gcap_l .Java. 
api_2_enh_gcap . cap . 

Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


Not testable 
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5.2.2.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


EnvelopeHandler available 

1 - Send envelope Menu Selection 

2 - The applet calls the getLength { ) 
method 

3 - The applet calls the getCapacity { ) 
method 


1 - Applet is triggered 

2 - No exception is thrown 

3 - No exception is ttirown; tine 
capacity is greater ttian the BER 
TLV Length 





5.2.2.14 Method getChannelldentifier 

Test Area Reference: Api_2_Enh_Gcid. 

5.2.2.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getChannelldentif ier { ) 

throws ToolkitException 

5.2.2.14.1.1 Normal execution 

• CRRNl: The method shall return the channel identifier byte value. 

• CRRN2: The channel identifier byte value returned shall be from the first Channel status TLV element. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

• CRRN4: The channel identifier is available for all triggered toolkit applets from the invocation to the 
termination of their processToolkit method if the EnvelopeHandler is available. 

5.2.2.14.1 .2 Parameter errors 
No requirements 

5.2.2.14.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if the Channel status TLV 
is not present. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if the Comprehension 
TLV Channel Status length is equal to 0. 



5.2.2.14.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Enh_Gcid.j ava. 
Api_2_Enh_Gcid_l .Java. 
api_2_enh_gcid.cap. 
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5.2.2.14.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


2 


N3 


3 


N4 


5 


C1 


4 


C2 


6 



5.2.2.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





1- Appletl is installed with maximum number of 
channel = 07. 

2- Appletl builds proactive commands OPEN CHANNEL 
with initO method in order to open all channels. 
ProactiveHandler . send { ) method is called. 




2- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id 
from 01 to 07 


1 


Successful Call 

1- Send envelope Event Download Channel Status 
with channel status TLV: 

channel status value = 0x8100. 

2- Call EnvelopeHandler .getChannelldentif ier { ) 
method 


1- Appletl is triggered 
2- Returns 0x01 




2 


Two channel status elements 

1- Send envelope Event Download Channel Status 
with two channel status TLV: 

first value = 0x8400 
second value = 0x8500. 

2- Call twice the 

EnvelopeHandler . getChannelldentif ier { ) method 


2- Returns twice 0x04 




3 


Verify current TLV 

1- Send envelope Event Download Channel Status 
with channel status TLV: 

Channel Status value = 0x0605 

ViewHandler .FindTLVO with Device IdentityTag. 

2- Call EnvelopeHandler .getChannelldentif ier { ) 
method . 

3- Compare EnvelopeHandler .getChannelldentif ier { ) 
and then ViewHandler .getValueByte (0) . 


2- Returns 0x06 

3- GetChannelldentifierQ 
=getValueByte(0) 




4 


UNAVAILABLE_ELEMENT exception 

1- Send envelope Menu Selection without Channel 
Status TLV. 

2- Call EnvelopeHandler .getChannelldentif ier { ) 
method. 


2- A Tooll<it 

exception. UNAVAILABLE 
ELEMENT is thrown. 




5 


Successful Call 

1- Send Envelope Event Download Channel Status 
with Channel Status TLV: 

Channel status value = 0x0600 

2- Call EnvelopeHandler .getChannelldentif ier { ) 
method . 


1 - Returns 0x06 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


OUT_OF_TLV_BOUNDARIES exception 

1- Send unrecognized envelope with a Channel 
Status TLV having a length equal to . 

2- Call EnvelopeHandler .getChannelldentif ier { ) 
method. 


2- A Toolkit 

exception.OUT OF TLV 
BOUNDARIES is thrown. 





5.2.2.15 Method getChannelStatus 

Test Area Reference: Api_2_Enh_Gcst. 

5.2.2.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getChannelStatus {byte channelldentif ier) 

throws ToolkitException 

5.2.2.15.1.1 Normal execution 

• CRRNl: The method shall return the value of the first Channel Status TLV element. 

• CRRN2: The Channel Status value returned shall be from the element whose channel identifier is equal to the 
Channelldentifier parameter. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

• CRRN4: The channel status is available for all triggered toolkit applets from the invocation to the termination 
of their processToolkit method if the EnvelopeHandler is available. 

5.2.2.1 5.1 .2 Parameter errors 
No requirements. 

5.2.2.15.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if no Channel Status TLV 
element with the right identifier could be found. 

• CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if a Channel Status TLV 
element with the right identifier could be found but its value is less than 2 bytes long. 



5.2.2.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.2.15.3 



Test area files 

Test_Api_2_Enh_Gcst.j ava. 
Api_2_Enh_Gcst_l .Java. 
api_2_enh_gcst.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


5 


N3 


7 


N4 


8 


CI 


1,2 


C2 


3,4 
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5.2.2.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





1- Appletl is installed with maximum 
number of channel = 01. 

2- Appletl builds proactive commands OPEN 
CHANNEL with init { ) method in order to 
open a channel . 

ProactiveHandler . send { ) method is called. 




2- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100 


1 


Channel status TLV is not present 

1- Send envelope Event Download Channel 
Status with no Channel status TLV 

2- Call 

EnvelopeHandler . getChannelStatus { 0x0 1 ) 
method . 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Channel status TLV with the identifier is not 
present 

1- Send envelope Event Download Channel 
Status with Channel status Value = 0x8200 

2- Call 

EnvelopeHandler . getChannelStatus { 0x01 ) 
method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




3 


Channel status TLV with a length equal to 

1- Send envelope Event Download Channel 
Status with Channel status length equal 
to 0. 

2- Call 

EnvelopeHandler . getChannelStatus { 0x01 ) 
method . 


2- UNVAILABLE_ELEMENT 
ToolkitException is thrown 




4 


Channel status TLV with a length equal to 1 

1- Send envelope Event Download Channel 
Status with Channel status length equal 
to 1. 

2- Call 

EnvelopeHandler . getChannelStatus { 0x0 1 ) 
method . 


2- OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




5 


Get channel status value 

1- Send envelope Event Download Channel 
Status with Channel status value=0x8100 . 

2- Call 

EnvelopeHandler . getChannelStatus { 0x01 ) 
method . 


2- Returns 0x8100 




6 


Get channel status value with 2 TLV 

1- Send envelope Event Download Channel 
Status with 2 channel status value: 
0x8100 and 0x8101. 

2- Call 

EnvelopeHandler . getChannelStatus { 0x01 ) 
method . 


2- Returns 0x8100 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Channel status TLV is currently selected TLV 

1- Send envelope Event Download Channel 
Status with channel status value 0x8100. 
Call ViewHandler.FindTLVO method with 
Device Identity Tag. 

2- Call 

EnvelopeHandler . getChannelStatus (0x01) 
method . 

3 - Compare 

EnvelopeHandler . getChannelStatus { 0x01) 
and ViewHandler .getValueShort (0) method 
results . 


2- Returns 0x81 00 

3- Check getChannelStatusQ 
=getValueShort(0) 




8 


Get channel status value after a proactive 
command 

1- Send envelope Event Download Channel 
Status with Channel status value=0x8100 . 

2- Call 

EnvelopeHandler . getChannelStatus { 0x01 ) 
method . 

3- Send a proactive command display text 

4- Call 

EnvelopeHandler .getChannelStatus (0x01) 
method . 


2- Returns 0x8100 
4- Returns 0x8100 


3- DISPLAY TEXT proactive 
command is fetched 

TERMINAL RESPONSE is 
issued 



5.2.2.16 Method getValueShort 

Test Area Reference: Api_2_Enh_Gvsh. 

5.2.2.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort {short valueOffset) 
throws ToolkitException 



5.2.2.16.1.1 



Normal execution 



CRRN 1 : Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.2.16.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.2.16.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



ETSI 



Release 6 



144 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.2.16.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Gvsh.java. 
Test Applet: Api_2_Enh_Gvsh_l.java. 

Cap File: api_2_enh_gvsh.cap. 



5.2.2.16.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Not testable 


C2 


1 



5.2.2.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the Unrecognized envelope with TLVs : 
Tag 02, Length 02 Value 83 81 
Tag 06, Length 06 Value 81 11 22 33 44 F5 
Tag 33, Length C9 Value 01 02 ... 






1 


getValueShort { ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueShort (2) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueShort (0) 


Result is 0x83 0x81 




4 


Search TLV 06h 








getValueShort (1) 


Result is 0x1 1 0x22 




5 


Search TLV 33h 








getValueShort {7E) 


Result is 0x7F 0x80 




6 


Search TLV 33h 








getValueShort (80) 


Result is 0x81 0x82 




7 


getValueShort {7F) 


Result is 0x80 0x81 




8 


Search TLV B3h 








getValueShort {C7) 


Result is 0xC8 0xC9 





5.2.2.17 Method getSize 

Test Area Reference: Api_2_Enh_Gtsz. 

5.2.2.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getSizeO 

5.2.2.17.1.1 Normal execution 

• CRRNl: Returns the BER TLV size, this includes the tag and the length. 

5.2.2.17.1.2 Parameter errors 
No requirements. 
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5.2.2.17.1.3 Context errors 

No requirements. 

5.2.2.17.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Enh_Gtsz.java. 

Test Applet: Api_2_Enh_Gtsz_l.java. 

Cap File: api_2_enh_gtsz.cap. 



5.2.2.17.3 



Test coverage 



CRR number 


Test case number 


1 


1,2 



5.2.2.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Send an unrecognized envelope of length 
0x33 {including tag and length) 






1 


Call getSizeO method just after 
triggering of the application. 


Returns 0x33 




2 


Call getSizeO method after a proactive 
command . 


Returns 0x33 





5.2.2.18 Method getlag 

Test Area Reference: Api_2_Enh_Gttg. 

5.2.2.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTagO 

5.2.2.18.1.1 Normal execution 

• CRRN 1 : Returns the BER Tag of the BER TLV list. 

5.2.2.18.1.2 Parameter errors 
No requirements. 

5.2.2.18.1.3 Context errors 
No requirements. 

5.2.2.18.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Enh_Gttg.java. 
Test Applet: Api_2_Enh_Gttg_l.java. 

Cap File: api_2_enh_gttg.cap. 
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5.2.2.18.3 



Test coverage 



CRR number 


Test case number 


1 


1,2 



5.2.2.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Send an unrecognized envelope 






1 


Call getTagO method just after 
triggering of the application. 


Returns OxXX 




2 


Call getTagO method after a proactive 
command. 


Returns OxXX 





5.2.3 Interface EnvelopeResponseHandler 
5.2.3.1 Method post 

Test Area Reference: Api_2_Erh_Post. 

5.2.3.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void post {boolean value) 

throws ToolkitException 

5.2.3.1.1.1 Normal execution 

• CRRNl: The toolkit applet can continue its processing after the call to post() method. 

• CRRN2: In case of CALL_CONTROL, the CAT Runtime Environment has to set the boolean value always to 
true. 

• CRRN3: The CAT Runtime Environment shall send the response before the emission of the next proactive 
command or when all the Toolkit Applets triggered by the event have finished their processing. 

• CRRN4: The CAT Runtime Environment has to map the boolean value to the correct status word. If the value 
is true it corresponds to a successful ending of the command status word "9000". If the value is false it 
corresponds to a warning status word "6200". 

5.2.3.1.1.2 Parameter errors 
No requirements. 

5.2.3.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 

• CRRC2: The method shall throw ToolkitException.B AD_LENGTH if the resulting response length is greater 
than 256 and the response data has to be retrieved by the GET RESPONSE command. 

5.2.3.1.2 Test area files 

Specific triggering: Unrecognized envelope: 
Test Source: Test_Api_2_Erh_Post.java. 
Test Applet: Api_2_Erh_Post_l.java. 

Cap File: api_2_erh_post.cap. 
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5.2.3.1.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


8,9 


N3 


4,5 


N4 


1,2,4,7 


C1 


3,6,7 


C2 


1 (see note) 


NOTE: This test is conditional and automatically performed if the capacity of the 
envelopeResponseHandler is greater than 256 bytes. 



5.2.3.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO and then post() 

{the handler is empty) 




9000 


2 


Fill the handler (appendTLVO to have 
bytes in it) and then post{) data with 
value TRUE 




FD data with status word 90 00 are 
returned 


3 


Verify that after a post the handler is no 
more available 

appendTLVO, then post{) and then 
appendTLV { ) 


ToolkitException. HANDLER 
NOT_AVAILABLE is thrown 
on the second appendTLV 




4 


construct the response (appendTLVO with 

0x10 data) and post it with value FALSE and 

then send a display text 

1- Send an unrecognizedEnvelope { ) to 
trigger the applet . 

2- Send a 

envelopeEventDownloadUserActivity { ) to 
get the 91 XX status word. 




1-12 data with status SW = 62 00 

2- SW = 91 15 is returned and display 
text is retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post() 

getTheHandlerO and postO, then send a 
display text 

1- Send an unrecognizedEnvelope { ) to 
trigger the applet . 

2- Send a 

envelopeEventDownloadUserActivity { ) to 
get the 91 XX status word. 




1-SW = 62 00 

2- SW = 91 1 5 is returned and display 
text is retrieved by a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandlerO, appendTLVO, send a 
display text and then postO . 


ToolkitException. HANDLER 
NOT_AVAILABLE is thrown 




7 


Verify that the handler is no more available 
after a post() 

getTheHandlerO, appendTLVO, then 
postO with value FALSE and then postO 
with value TRUE 


ToolkitException. HANDLER 
NOT_AVAILABLE is thrown 


1 2 data with status word 62 00 are 
returned 


8 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandlerO, appendTLVO, postO 
with value FALSE 




1 2 data with status word 90 00 are 
returned 


9 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandlerO, appendTLVO, postO 
with value TRUE 




1 2 data with status word 90 00 are 
returned 


10 


Resulting response length greater than 256 

getTheHandlerO, appendTLVO {data 
length 252 bytes), appendTLV{) {data 
length 1 byte), post{) with value TRUE 


javacard.framework.APDUEx 
ception.BAD_LENGTH is 
thrown 
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5.2.3.2 Method postAsBERTLV 

Test Area Reference:Api_2_Erh_Poab. 

5.2.3.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV { boolean value, 

byte tag) 
throws ToolkitException 

5.2.3.2.1.1 Normal execution 

CRRNl: The toolkit applet can continue its processing after the call to postAsBERTLV() method. 

CRRN2: In case of CALL_CONTROL, the CAT Runtime Environment has to set the boolean value always to 
true. 

CRRN3: The CAT Runtime Environment shall send the response before the emission of the next proactive 
command or when all the Toolkit Applets triggered by the event have finished their processing. 

CRRN4: The byte tag is the BER Tag at the beginning of the Comprehension TLV list. 

CRRN5: The CAT Runtime Environment has to map the Boolean value to the correct status word. If the value 
is true it corresponds to a successful ending of the command status word "9000". If the value is false it 
corresponds to a warning status word "6200". 

5.2.3.2.1 .2 Parameter errors 
No requirements. 

5.2.3.2.1 .3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException.H ANDLER_NOT_AV AILABLE if the handler is busy. 

• CRRC2: The method shall throw ToolkitException.B AD_LENGTH if the resulting response length is greater 
than 256 and the response data has to be retrieved by the GET RESPONSE command. 

5.2.3.2.2 Test area files 

Specific triggering: Unrecognized envelope: 
Test Source: Test_Api_2_Erh_Poab.java. 
Test Applet: Api_2_Erh_Poab_l.java. 

Cap File: api_2_erh_poab.cap. 



5.2.3.2.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


8,9 


N3 


4,5 


N4 


2,4,7 


N5 


1,2,4,7 


C1 


3,6,7 


C2 


10 
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5.2.3.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO and then postAsBERTLVQ 

{the handler is empty) 




02 data with status word 90 
00 are returned, the tag shall 
be 33 and the length is 00 


2 


Fill the handler and then postAsBERTLV() 
the data with value TRUE, and tag 33 




FF data with status word 90 
00 are returned, the tag shall 
be 33 


3 


appendTLVO, postAsBERTLV() and then 
appendTLVO 


ToolkitException.HANDLER_NOT_AV 
AILABLE is thrown on the second 
appendTLV 




4 


construct the response (appendTLVQ with 
0x10 data) and postAsBERTLV() with value 
FALSE, tag 75 and then send a display text 

1- Send an unrecognizedEnvelope { ) to 
trigger the applet . 

2- Send a 

envelopeEventDownloadUserActivity { ) to 
get the 91 XX status word. 




1- 14 data with status SW = 
62 00 

2-SW = 91 15 is returned 
and display text is retrieved 
by a FETCH 


5 


getTheHandlerO and postAsBERTLV() with 
value FALSE, then send a display text 

1- Send an unrecognizedEnvelope { ) to 
trigger the applet. 

2- Send a 

envelopeEventDownloadUserActivity { ) to 
get the 91 XX status word. 




1- 02 data are returned with 
status SW = 62 00 

2-SW = 91 15 is returned 
and display text is retrieved 
by a FETCH 


6 


Verify it is not possible to postAsBERTLVQ 
after a proactive command 

getTheHandlerO, appendTLVO, send a 
display text and then postAsBERTLV{ ) . 


ToolkitException.HANDLER_NOT_AV 
AILABLE is thrown on the 
postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLVQ 

getTheHandlerO, appendTLVO {with data 
length = 0x10, then postAsBERTLV{ ) with 
value FALSE, tag 56 and then 
postAsBERTLV{) with value TRUE, tag 2 8 


Tooll<itException.HANDLER_NOT_AV 
AILABLE is thrown on the second 
postAsBERTLV 


1 4 data with status word 62 
00 are returned, the tag shall 
be 56 


8 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandler { ) , appendTLV { ) , 
postAsBERTLV{) with value FALSE 




1 2 data with status word 90 
00 are returned 


9 


CALL_CONTROL, the CAT Runtime 

Environment set the boolean value always 

to true 

Trigger the applet with CALL CONTROL 
getTheHandler { ) , appendTLV { ) , 
postAsBERTLV{) with value TRUE 




1 2 data with status word 90 
00 are returned 


10 


Resulting response length greater than 256 

getTheHandler {) , appendArray { ) {255 
bytes), postAsBERTLV{) with value TRUE 


javacard.frameworl<.APDUException. 
BAD_LENGTH is thrown 
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5.2.3.3 Method getLength 

Test Area Reference: Api_2_Erh_Glen. 

5.2.3.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getLength {) 

throws ToolkitException 

5.2.3.3.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

5.2.3.3.1 .2 Parameter errors 
No requirements. 

5.2.3.3.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.3.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Glen.java. 
Test Applet: Api_2_Erh_Glen_l.java. 

Cap File: api_2_erh_glen.cap. 



5.2.3.3.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


6 



5.2.3.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength { ) 


Result of getLengthO is 




2 


appendTLVO with length of 7 

getLength { ) 


Result of getLengthO is 9 




3 


Clear the handler and appendTLV() with 
Length of getCapacity()-3 

getLength { ) 


Result of getLengthO is 
getCapacity{)-3 




4 


Build a 7Fh Envelope response handler 

getLength { ) 


Result of getLengthO is 81 h 




5 


Build a 80h Envelope response handler 
getLengthO 


Result of getLengthO is 83h 




6 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then getLengthO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.4 Method copy 

Test Area Reference: Api_2_Erh_Copy. 

5.2.3.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short copy{byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.3.4.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.3.4.1 .2 Parameter errors 

• CRRPl : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is greater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.3.4.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

5.2.3.4.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Copy.java. 
Test Applet: Api_2_Erh_Copy_Ljava. 

Cap File: api_2_erh_copy.cap. 



5.2.3.4.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


P1 


1 


P2 


2,3,4,5,6 


P3 


7 


C1 


15 
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5.2.3.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO with value length of 7 
NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copy {) 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




6 


dstLength < 

copy { ) 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy {) 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy {) 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy { ) 

dstBuffer.length = 0x8F 
dstOffset = 3 
dstLength = 0x8C 


Result of copyO is 0x8F 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy { ) 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, copy with length =0 

copy { ) 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copyO is 15 




15 


HANDLER_NOT_AVAILABLE exception 

Call post() method, then copy{) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.5 Method findTLV 

Test Area Reference: Api_2_Erh_Find. 

5.2.3.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte findTLV{byte tag, byte occurrence) 
throws ToolkitException 

5.2.3.5.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.3.5.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.3.5.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

5.2.3.5.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Find.java. 
Test Applet: Api_2_Erh_Find_Ljava. 

Cap File: api_2_erh_fmd.cap. 



5.2.3.5.3 



Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


14 
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5.2.3.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Invalid input parameter 

findTLVO 

Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 










Search 1st TLV 

findTLVO 
Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Search a tag with wrong occurrence 

findTLVO 
Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

findTLVO 
Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




14 


HANDLER_NOT_AVAILABLE exception 

Call postQ method, then findTLV() 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.6 Method getValueLength 

Test Area Reference: Api_2_Erh_Gvle. 

5.2.3.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 



ETSI 



Release 6 



155 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.3.6.1.1 



Normal execution 



CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.3.6.1.2 

No requirements. 

5.2.3.6.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.6.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Gvle.java. 
Test Applet: Api_2_Erh_Gvle_l.java. 

Cap File: api_2_erh_gvle.cap. 



5.2.3.6.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


7 


C2 


1 



5.2.3.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO 02 02 02 02 
findlLVQ with TAG 03 








getValueLengthO 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




2 


appendTLVO with TAG OD and length 00 








Search TLV ODh 








getValueLength { ) 


Result is OOli 




3 


Clear the handler and append TLV with TAG 
OD and length 02 








Search TLV ODh 








getValueLength { ) 


Result is 02li 




4 


Clear the handler and appendTLVO with TAG 
OD and length 0x7F 








Search TLV ODh 








getValueLengthO 


Result is 7Fli 




5 


Clear the handler and appendTLVO with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength { ) 


Result is soil 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Clear the handler and appendTLV() with TAG 
OD and length OxFI 








Search TLV ODh 








getValueLength { ) 


Result is Flh 




7 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then getValueLength { ) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.7 Method getValueByte 

Test Area Reference: Api_2_Erh_Gvby. 

5.2.3.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte {short valueOffset) 
throws ToolkitException 



5.2.3.7.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 
(1 byte). 



5.2.3.7.1.2 



Parameter errors 



• CRRPl : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.3.7.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.7.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Gvby.java. 
Test Applet: Api_2_Erh_Gvby_l.java. 

Cap File: api_2_erh_gvby.cap. 



5.2.3.7.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


9 


C2 


1 
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5.2.3.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO 82 02 81 82, appendTLVQ 81 03 

11 22 FE 

findTLV with TAG 03 








getValueByte (0) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByte (3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h 








getValueByte (2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLVO with TAG OD, Length 0x7E, 
Value: 00, 01,..., 7D 








getValueByte {7D) 


Result is 7Dh 




6 


clear the handler, appendTLVQ with TAG OD, 
Length 0x80, Value: 00, 01, ..., 7F 








getValueByte {7E) 


Result is 7Eh 




7 


getValueByte {7F) 


Result is 7Fh 




8 


Clear the handler, appendTLVQ with TAG OD, 
Length OxFI, Value: 00, 01, ..., FO 








getValueByte (FO) 


Result is FOh 




9 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then getValueByte { ) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.8 Method copyValue 

Test Area Reference: Api_2_Erh_Cpyv. 



5.2.3.8.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue {short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.3.8.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.3.8.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 
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5.2.3.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.8.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Cpyv.java. 
Test Applet: Api_2_Erh_Cpyv_l.java. 

Cap File: api_2_erh_cpyv.cap. 



5.2.3.8.3 



Test coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14, 16 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


17 


C2 


11 



5.2.3.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO with TAG: OD and length 16 
Select Text String TLV 








copyValue {) with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


clear the handler, appendTLVQ with TAG: OD 

and length 6 

Select Text String TLV 








valueOffset > Text String Length 

copyValue { ) 
valueOffset = 6 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

copyValue { ) 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

copyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

copyValue { ) 
valueOffset = 2 
dstBuffer. length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








copyValue { ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


clear the handler, appendTLV() with TAG: OD 

and value: 04 00 01 ...OF 

Select Text String TLV 








Successful call 

copyValue { ) 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 

clear the handler 

AppendTLV with TAG OxOD and value 0x01 

0x02 ... 0x83 








Successful call 

copyValue { ) 
valueOffset = 2 
dstBuffer. length = 0x86 
dstOffset = 3 
dstLength = 0x81 


Result of copyValueO is 0x84 




15 


Compare buffer 

buffer = 

55 55 55 01 02 

03 04 05 06 07 

08 09 ... 81 

55 55 55 55 55 


Result is OOh 




16 


Successful call, copyValue() with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 




17 


HANDLER_NOT_AVAILABLE exception 

Call post() method, then copyValue() 


ToolkltException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.9 Method compareValue 

Test Area Reference: Api_2_Erh_Cprv. 

5.2.3.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte compareValue {short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws Java. lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.3.9.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.3.9.1 .2 Parameter errors 

• CRRPl : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

5.2.3.9.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException. UNA VAILABLE_ELEMENT. 

5.2.3.9.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Cprv.java. 
Test Applet: Api_2_Erh_Cprv_Ljava. 

Cap File: api_2_erh_cprv.cap. 
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5.2.3.9.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


C1 


19 


C2 


11 



5.2.3.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO with TAG: OD and length 16 
Select Text String TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLVO with TAG: OD and length 6 
Select Text String TLV 








valueOffset > Text String Length 

compareValue { ) 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

compareValue { ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

compareValue { ) 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLength > Text String 
length 

compareValue { ) 
valueOffset = 2 
compareBuf fer. length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareValue { ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




12 


appendTLV with TAG: OD and value: 04 00 01 

...OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue { ) 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 03 
04 05 06 07 08 
09 OA OB ... 81 
55 55 55 55 55 

clear the hancJler 

AppendTLV with TAG OxOD ancJ value 0x01 

0x02 ... 0x83 








Compare buffers 

compareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 0x81 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 03 
04 05 06 07 08 
09 OA OB ... 84 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 03 
04 05 06 07 08 
09 OA OB ... 82 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Successful call, compareValue() with length =0 

compareBuf fer . length = 15 
compareOf f set = 15 
compareLength = 


Result of compareValueO is 




19 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then compareValue() 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.1 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference: Api_2_Erh_Facyb_Bs. 

5.2.3.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short f indAndCopyValue {byte tag, 

byte [] dstBuffer, 
short dstOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.3.10.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.3.10.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.3.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.10.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facyb_Bs.java. 
Test Applet: Api_2_Erh_Facyb_Bs_Ljava. 

Cap File: api_2_erh_facyb_bs.cap. 



5.2.3.10.3 



Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


17 
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5.2.3.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLVO with TAG: OD and length 16 
Select Text String TLV 








dstOffset > dstBuffer.length 

f indAndCopyValue { ) 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstOffset + length >dstBuffer.length 

f indAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 15 

dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLV() with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f IndAndCopyValue { ) 
tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




7 


appendTLVO with TAG: OD and value: 04 00 01 
...OF 








Successful call 

f IndAndCopyValue { ) 
Tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = 2 


Result of findAndCopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


clear the handler, appendTLVQ with TAG: OD 
and value: 04 00 01 ...OF 








append a 2"° Text String TLV 








Successful call 

f IndAndCopyValue { ) 
tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


clear the handler, appendTLVQ with TAG: OD 
and value: 04 00 01 ...OF 








Successful call (with tag 8Dh) 

f indAndCopyValue { ) 
tag = 8Dh 

dstBuffer. length = 17 
dstOffset = 


Result of findAndCopyValueO is 

17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

clear the Handler. 

AppendTLVO with tag OxOF and value 

01 02 ... 80 








Successful call (with tag BFh) 

f IndAndCopyValue { ) 
tag = BFh 

dstBuffer. length = 0x83 
dstOffset = 3 


Result of findAndCopyValueO is 
0x83 




16 


Compare buffer 

buffer = 55 55 55 00 01 ... 80 


Result is OOh 




17 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then findAndCopyValue() 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 1 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: Api_2_Erh_Facybbs_Bss. 

5.2.3.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
ToolkitException 



5.2.3.11.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.3.11.1.2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 
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• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.3.11.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.11.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facybbs_Bss.java. 
Test Applet: Api_2_Erh_Facybbs_Bss_l.java. 

Cap File: api_2_erh_facybbs_bss.cap. 



5.2.3.11.3 



Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18,24 


N4 


20, 21,22, 23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


P4 


26 


CI 


25 



5.2.3.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLVO with TAG: OD and length 16 








dstOffset > dstBuffer.length 

f indAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 5 

dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

f indAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f indAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f indAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


dstLength < 

f IndAndCopyValue { ) 
dstBuffer. length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLVQ with TAG: OD and length 6 








valueOffset > Text String Length 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = S 

dstBuffer. length = 15 

dstOffset = 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue { ) 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 2 
dstBuffer. length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Clear the handler, appendTLV() with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f IndAndCopyValue { ) 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLength { ) method 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown. 




12 


clear the handler and appendTLVQ with TAG: 
OD and value: 04 00 01 ... OF 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 20 

dstOffset = 3 

dstLength = 12 


Result of findAndCopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 {no specific 

DCS byte) 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 20 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO Is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result Is OOh 




18 


Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 2 

valueOffset = 

dstBuffer. length = 6 

dstOffset = 

dstLength = 6 


Result of findAndCopyValueO Is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result Is OOh 




20 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue { ) 
tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO Is 

17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result Is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 

AppendTLVO with tag OxOF and value 01 02 

... 80 








Successful call (with tag 8Fh) 

f IndAndCopyValue { ) 
tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 0x83 
dstOffset = 
dstLength = 0x8 


Result of findAndCopyValueO Is 
0x80 




23 


Compare buffer 

buffer = 00 01 ... 80 55 55 55 


Result is OOh 




24 


Successful call, findAndCopyValue() with 
length =0 

dstBuffer. length = 16 
dstOffset = 16 
dstLength = 


Result of findAndCopyValueO is 
16 




25 


Invalid parameter 

f IndAndCopyValue { ) 

occurrence = 


ToolkitExceptlon.BAD_INPUT_PA 
RAMETER Is thrown 




26 


HANDLER_NOT_AVAILABLE exception 

Call postQ method, then flndAndCopyValueQ 


ToolkitExceptlon. HANDLER NOT 
AVAILABLE Is thrown 













5.2.3.12 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: Api_2_Erh_Facrb_Bs. 
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5.2.3.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte[] compareBuf f er, 
short compareOf f set) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.3.12.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1 . 

• CRRN6: The search method is comprehension required flag independent. 

5.2.3.12.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.3.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.3.12.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facrb_Bs.java. 
Test Applet: Api_2_Erh_Facrb_Bs_l.java. 

Cap File: api_2_erh_facrb_bs.cap. 



5.2.3.12.3 



Test coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11, 15 


N6 


17, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


18 
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5.2.3.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO with TAG: OD and length 16 








findAndCompareValueO with a null dstBuffer and 
tag ODh 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = ODh 

compareBuffer.length =20 
compareOffset =20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length =20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareOffset + length > 
compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length =20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLV() with TAG 02 
and Length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue { ) 
tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




7 


Verify current TLV 

getValueLength { ) 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuf f er = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




9 


Verify current TLV 

getValueLength { ) 


Result is 17 




10 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




12 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call with 2 TLVs 

clear {) the Handler 

AppendTLVO with tag OxOD and value set 

to 00 01 ... 80 81 

Append a second TLV with tag OxOD and 

value set to 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE OF . . 81 








Compare buffers 

f indAndCompareValue { ) the first TLV 
compareOf f set = 3 


Result is OOh 




14 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE . . 7F 81 








Compare buffers 

f indAndCompareValue {) the first TLV 

compareOffset = 3 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE . . 80 80 








Compare buffers 

compareOffset = 3 


Result is +1 




16 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f indAndCompareValue { ) 
tag = 8Dh 

CompareBuf fer. length = 17 
compareOffset = 


Result is OOh 




17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

f indAndCompareValue { ) 
tag = 8Fh 

CompareBuf fer . length = 16 
compareOffset = 


Result is OOh 




18 


HANDLER_NOT_AVAILABLE exception 

Call post() method, then flndAndCompareValue() 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 
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5.2.3.13 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: Api_2_Erh_Facrbbs_Bss. 

5.2.3.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.3.13.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3 : if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.3.13.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException 
shall be thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 

5.2.3.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 
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5.2.3.13.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Facrbbs_Bss.java. 
Test Applet: Api_2_Erh_Facrbbs_Bss_l.java. 

Cap File: api_2_erh_facrbbs_bss.cap. 



5.2.3.13.3 



Test coverage 



CRR number 


Test case number 


N1 


12, 13 


N2 


15,13 


N3 


14, 18,22,21,26 


N4 


16, 19,23 


N5 


17, 19 


N6 


25,24 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


P4 


11 


C1 


27 



5.2.3.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








compareOffset > compareBuffer.length 

f IndAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 

compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 





ETSI 



Release 6 



174 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


7 


clear the handler and appendTLV() with TAG 
and length of 6 








valueOffset > Text String Length 

f IndAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue { ) 
valueOffset = -1 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue { ) 
valueOffset = 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue { ) 
valueOffset = 2 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




12 


appendTLVQ with TAG 02 and length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue { ) 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




13 


Verify current TLV 

getValueLength { ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




14 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




15 


Verify current TLV 

getValueLength { ) 


Result is 17 




16 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Initialize compareBuffer 

clear {) the handler. 

AppendTLV with tag OxOD and data = 01 02 

03 ... 80 81 

compareBuffer = 

55 55 55 01 02 

03 04 05 06 07 

08 09 OA OB OC 

OD OE ... 80 81 








Compare buffers 

f IndAndCompareValue { ) 
tag = OxOD 
occurrence = 1 
valueOffset = 
compareOf f set = 3 
compareLength = 0x81 


Result is OOh 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE ... 7F 81 








findAndCompareValueO with same parameters 


Result is -1 




20 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
OD OE ... 80 80 








findAndCompareValueO with same 
parameters 


Result is +1 




21 


append a second Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 

55 55 55 01 ... 80 81 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 3 
compareLength = 0x81 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




23 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




24 


clear the handler and appendTLV() with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag BDh) 

f IndAndCompareValue { ) 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuffer. length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


25 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

f IndAndCompareValue { ) 
tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuffer. length = 16 
compareOf f set = 
compareLength = 16 


Result is OOh 




26 


Successful call, findAndCompareValue() with 
length =0 

CompareBuffer. length = 16 
compareOf f set = 16 
compareLength = 


Result of findAndCompareValue 
is 00 




27 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then 
f IndAndCompareValue { ) 


ToolkitException. HANDLER NOT 
_AVAILABLE is thrown 





5.2.3.14 Method appendArray 

Test Area Reference: Api_2_Erh_Apda. 
5.2.3.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendArray {byte [] buffer, 

short offset, 
short length) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.3.14.1.1 Normal execution 

• CRRN 1 : appends a buffer into the EditHandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

5.2.3.14.1.2 Parameter errors 

• CRRPl: if buffer is null, a Java. lang.NullPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.3.14.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 
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5.2.3.14.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Apda_Bss.java. 
Test Applet: Api_2_Erh_Apda_Bss_l.java. 

Cap File: api_2_erh_apda_bss.cap. 



5.2.3.14.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


12 



5.2.3.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Initialize the envelope response handler with a 
TLV of length 1 






1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 5 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

appendArray { ) 
buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Offset + length > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

appendArray { ) 
buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

appendArray { ) 

buffer.length = getCapacity { ) +1 

offset = 

length = getCapacity {) +1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








findTLVO 0x81 








Successful call 

appendArray { ) 
buffer = FF FE ... F8 

offset = 
length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Clear the handler 








Successful call 

appendArray { ) 
buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare handler 

compareBuf fer = FF FE ... F8 


Result is OOh 




10 


Successful call 

appendArray { ) 
buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyQ method 








Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result is OOh 




11 


Successful call 

appendArray { ) 
buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result is OOh 




12 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then appendArray { ) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 5 Method appendTLV(byte tag, byte value) 

Test Area Reference: Api_2_Erh_Aptlbb. 

5.2.3.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV{byte tag, byte value) 
throws ToolkitException 

5.2.3.15.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.15.1.2 Parameter errors 
No requirements. 

5.2.3.15.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 
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5.2.3.15.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbb.java. 
Test Applet: Api_2_Erh_Aptlbb_l.java. 

Cap File: api_2_erh_aptlbb.cap. 



5.2.3.15.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 



5.2.3.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call appendTLVQ method 


ToolkitException.HANDLER OVE 
RFLOW is thrown. 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 
method 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh 








Call copyQ method 








Compare handler 

compareBuf fer = 84 01 00 


Result is OOli 




4 


Successful call 

appendTLV { ) 
tag = Olh 
value = Feh 








Call copyO method 








Compare handler 

compareBuf fer = 84 01 00 01 01 FE 


Result is OOh 




5 


HANDLER_ NOT_AVAILABLE exception 

Call post{) method, then appendTLVO 


ToolkitException.HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 6 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: Api_2_Erh_Aptlbbb. 

5.2.3.16.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, byte valuel, byte value2) 
throws ToolkitException 
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5.2.3.16.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.16.1.2 Parameter errors 
No requirements. 

5.2.3.16.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.16.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptl Bbb.java. 
Test Applet: Api_2_Erh_Aptl Bbb_l .Java. 

Cap File: api_2_erh_aptl bbb.cap. 



5.2.3.16.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 



5.2.3.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO with length of 
getCapacity()-1 








Handler Overflow exception: 
Call appendTLVQ method 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 
method 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyQ method 








Compare handler 

compareBuf fer = 84 02 00 01 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyQ method 








Compare handler 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then appendTLV {) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.17 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: Api_2_Erh_Aptlb_Bss. 

5.2.3.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte [] value, 
short valueoffset, 
short valuelength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.3.17.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.17.1.2 Parameter errors 

• CRRPl: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.3.17.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.3.17.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlb_Bss.java. 
Test Applet: Api_2_Erh_Aptlb_Bss_l.java. 

Cap File: api_2_erh_aptlb_bss.cap. 
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5.2.3.17.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


14 


C3 


8 



5.2.3.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

appendTLV { ) 
value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

appendTLV { ) 
value . length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArrayO with length of 
getCapacity()-1, appendTLVQ 

value.length = 256 
valueOffset = 
valueLength = 254 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler, appendTLVQ 

value.length = 256 
valueOffset = 
valueLength = 256 


ToolkJtException.BAD_INPUT_PA 
RAMETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

appendTLV { ) 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Call copyQ method 








Compare handler 

CompareBuf fer = 04 08 FF FE ... F8 


Result is 00 




11 


Successful call 

appendTLV { ) 

tag = 85h 

value = 01 ... 7 

valueOffset = 2 

valueLength = 6 








Call copyQ method 








Compare handler 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result is 00 




12 


Successful call 

appendTLV { ) 

tag = 01 

value = 11 22 ... 88 

valueOffset = 2 

valueLength = 4 








Call copyQ method 








Compare handler 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result is 00 




13 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

value = 00 01 ... 7F 

valueOffset = 

valueLength = 80h 








Call copyQ method 








Compare handler 

compareBuf fer = 04 81 80 00 01...7F 


Result is 00 




14 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then appendTLV {) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.1 8 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: Api_2_Erh_Aptlbb_Bss. 



5.2.3.18.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte valuel 
byte [] value2 , 
short value2of f set , 
short value21ength) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
ToolkitException 

5.2.3.18.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.3.18.1.2 Parameter errors 

• CRRPl: if value2 is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.3.18.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 254, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.3.18.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbb_Bss.java. 
Test Applet: Api_2_Erh_Aptlbb_Bss_l.java. 

Cap File: api_2_erh_aptlbb_bss.cap. 



5.2.3.18.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


14 


C3 


8 



5.2.3.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


value20ffset < 

appendTLV { ) 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


value2Length > value2. length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


value2Length < 

appendTLV { ) 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArrayO with length of 

getCapacity()-1 

appendTLVO 

value2 . length = 25S 
value20ffset = 
value2Length = 254 


Tooll<itException.HANDLER OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handlerappendTLV{ ) 
value2 . length = 256 
value20ffset = 
value2Length = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

appendTLV { ) 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Call copyO method 








Compare handler 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result is 00 




11 


Successful call 

appendTLV { ) 
tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copvO method 








Compare handler 

CompareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result is 00 




12 


Successful call 

appendTLV { ) 
tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare handler 

CompareBuf fer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Clear the handler 








Successful call 

appencJTLV { ) 
tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare handler 

compareBuf fer = 04 81 80 00 01...7F 


Result is 00 




14 


HANDLER_NOT_AVAILABLE exception 

Call post{) methoca, then appencJTLVO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.19 Method clear 

Test Area Reference: Api_2_Erh_Cler. 
5.2.3.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

Public void clear {) 

throws ToolkitException 

5.2.3.19.1.1 Normal execution 

• CRRNl: Clears the TLV list of an EditHandler and resets the current TLV selected. 



5.2.3.19.1.2 
No requirements. 

5.2.3.19.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.19.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Cler.java. 
Test Applet: Api_2_Erh_Cler_l.java. 

Cap File: api_2_erh_cler.cap. 



5.2.3.19.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


CI 


3 
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5.2.3.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




3 


HANDLER_NOT_AVAILABLE exception 

Call appendTLVO method, then post{) and 
then clear {) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.20 Method getCapacity 

Test Area Reference: Api_2_Erh_Gcap. 

5.2.3.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity { ) 

5.2.3.20.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 

5.2.3.20.1 .2 Parameter errors 
No requirements 

5.2.3.20.1.3 Context errors 

• CRRC 1 : The method shall throw HANDLER_NOT_AVAILABLE ToolkitException if the handler is busy. 

5.2.3.20.2 Test area files 

Test Source: Test_Api_2_Erh_Gcap.java. 
Test Applet: Api_2_Erh_Gcap_l.java. 

Cap File: api_2_erh_gcap.cap. 

5.2.3.20.3 Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


Tested in CAT Runtime Environment part: FWK_MHA_ERHD 
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5.2.3.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


EnvelopeResponseHandler available 

1- Send envelope Menu Selection 

2- The applet calls getTheHandler { ) method 

3- The applet calls getCapacity { ) method 
on the EnvelopeResponseHandler 

4- The applet fills the handler with the 
maximum capacity using AppendTLVO method 

5- The applet calls clear {) method on the 
EnvelopeResponseHandler 

6- The applet fills the handler with the 
maximum capacity plus one, using 
AppendTLVO method 


1 - Applet is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- No exception is thrown 

5- No exception is thrown 

6- HANDLER_OVERFLOW 
exception is thrown 





5.2.3.21 Method getValueShort 

Test Area Reference: Api_2_Erh_Gvsh. 

5.2.3.21.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort {short valueOffset) 
throws ToolkitException 



5.2.3.21.1.1 



Normal execution 



CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.3.21.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.3.21.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.3.21.2 Test area files 

Specific triggering: Unrecognized Envelope: 
Test Source: Test_Api_2_Erh_Gvsh.java. 
Test Applet: Api_2_Erh_Gvsh_l.java. 

Cap File: api_2_erh_gvsh.cap. 



5.2.3.21.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


9 


C2 


1 
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5.2.3.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLVO 82 02 81 82, appendTLV() 81 03 
11 22 FE 

findTLVO with TAG 03 








getValueShort (0) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




2 


Search TLV Olh 








getValueShort (3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV Olh 








getValueShort (1) 


Result is 22h FEh 




4 


Search TLV 02h 








getValueShort (0) 


Result is 81 h82h 




5 


appendTLVO with TAG OD, Length Ox7E, 
Value: 00, 01, . . . , 7D 








getValueShort {7C) 


Result is 7Ch 7Dh 




6 


clear the handler, appendTLVO with TAG 
OD, Length 0x80, Value: 00, 01, ..., 7F 








getValueShort {7D) 


Result is 7Dh 7Eh 




7 


getValueShort {7E) 


Result is 7Eh 7Fh 




8 


clear the handler, appendTLVO with TAG 
OD, Length OxFl, Value: 00, 01, ..., FO 








getValueShort (EF) 


Result is EFh FOh 




9 


HANDLER_NOT_AVAILABLE exception 

Call postO method, then getValueShort { ) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.22 Method appendTLV(byte tag, byte valuel , short value2) 

Test Area Reference: Api_2_Erh_Aptlbbs. 

5.2.3.22.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV{byte tag, 

byte valuel, 
short value2) 
throws ToolkitException 

5.2.3.22.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (3-byte element(l-byte,l-short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.22.1.2 Parameter errors 
No requirements. 

5.2.3.22.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 
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5.2.3.22.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbbs.java. 
Test Applet: Api_2_Erh_Aptlbbs_l.java. 

Cap File: api_2_erh_aptlbbs.cap. 



5.2.3.22.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 



5.2.3.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO with length of 
getCapacity()-1 








Handler Overflow Exception: 
Call appendTLVO method 


ToolkitException. HANDLER 
VERFLOW is thrown 




2 


clear the handler, append the handler with TLVs: 

81 03 11 22 33 

82 03 99 77 00 








Select Command Details TLV 








Call appendTLVO method 








Verify Current TLV: Call getValueLength() 
method 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call copyO method 








Compare handler 
compareBuffer = 84 03 00 01 02 


Result is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh 
value2 = FDh FCh 








Call copyO method 








Compare handler 
compareBuffer = 84 03 00 01 02 01 03 FE FD FC 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then AppendTLVO 


ToolkitException. HANDLER N 
OT AVAILABLE is thrown 





5.2.3.23 Method appendTLV(byte tag, short value) 

Test Area Reference: Api_2_Erh_Aptlbs. 

5.2.3.23.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

short value) 
throws ToolkitException 
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5.2.3.23.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte or 1 -short element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.23.1 .2 Parameter errors 
No requirements. 

5.2.3.23.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.23.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbs.java. 
Test Applet: Api_2_Erh_Aptlbs_l.java. 

Cap File: api_2_erh_aptlbs.cap. 



5.2.3.23.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


CI 


1 


C2 


5 



5.2.3.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity { ) -1 








Handler Overflow Exception: 
Call appendTLVQ method 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 
method 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh Olh 








Call copyQ method 








Compare handler 

compareBuf fer = 84 02 00 01 


Result is OOli 





ETSI 



Release 6 



192 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

appendTLV { ) 
tag = Olh 
value = FEh FFh 








Call copyO method 








Compare handler 

compareBuf fer = 84 02 00 01 01 02 FE FF 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then AppendTLV {) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.3.24 Method appendTLV(byte tag, short valuel , short value2) 

Test Area Reference: Api_2_Erh_Aptlbss. 

5.2.3.24.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

short valuel, 
short value2) 
throws ToolkitException 

5.2.3.24.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (4-byte element(2-short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.3.24.1 .2 Parameter errors 
No requirements. 

5.2.3.24.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.3.24.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlbss.java. 
Test Applet: Api_2_Erh_Aptlbss_l.java. 

Cap File: api_2_erh_aptlbss.cap. 



5.2.3.24.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


5 
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5.2.3.24.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO method with length 
equal getCapacity()-1 








Handler Overflow Exception: 
Call appendTLVO method 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call appendTLVO method 








Verify Current TLV: Call getValueLength() 
method 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call copyO method 








Compare handler 
compareBuffer = 84 04 00 01 02 03 


Result is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh FDh 
value2 = FCh FBh 








Call copyO method 








Compare handler 

compareBuffer = 84 04 00 01 02 03 01 04 FE FD 

FCFB 


Result is OOh 




5 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then appendTLVO 


ToolkitException.HANDLER NOT 
AVAILABLE is thrown 





5.2.3.25 Method appendTLV(byte tag, byte[] valuel , short valuel Offset, short 
valuel Length, byte[] value2, short value20ffset, short value2Length) 

Test Area Reference: Api_2_Erh_Aptlb_Bss_Bss. 



5.2.3.25.1 



Conformance requirements 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte [] valuel, 
short valuelOf f set , 
short valuelLength, 
byte [] value2 , 
short value20f f set , 
short value2Length) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.3.25.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2 byte arrays format). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.3.25.1.2 Parameter errors 

• CRRPl: If valuel or value2 is null, a NullPointerException is thrown. 

• CRRP2: If valuelOffset or valuelLength or both would cause access outside valuel array bounds, or if 
valuelLength is negative, an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: If value20ffset or value 2Length or both would cause access outside value2 array bounds, or if 
value2Length is negative, an ArraylndexOutOfBoundsException is thrown. 



5.2.3.25.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: If valuelLength or value2Length is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.3.25.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Erh_Aptlb_Bss_Bss.java. 
Test Applet: Api_2_Erh_Aptlb_Bss_Bss_l.java. 

Cap File: api_2_erh_aptlb_bss_bss.cap. 



5.2.3.25.3 



Test coverage 



CRR number 


Test case number 


N1 


18, 19,20,21 


N2 


17 


P1 


1,2 


P2 


3, 4, 5, 6, 7 


P3 


8,9, 10, 11, 12 


CI 


13 


C2 


22 


C3 


14, 15 



5.2.3.25.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null valuel 


NullPointerException is thrown 




2 


Null value2 


NullPointerException is thrown 




3 


ValuelOffset > valuel. length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 5 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


ValuelOffset <0 

appendTLV { ) 
valuel . length = 5 
valuelOffset = -1 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


ValuelLength > valuel. length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 6 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


ValuelOffset + valuel Length > valuel .length 

appendTLV { ) 
Valuel . length = 5 
valuelOffset = 3 
ValuelLength = 3 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




7 


Valuel Length <0 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = -1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




8 


Value20ffset > value2.length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




9 


Value20ffset < 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




10 


Value2Length > value2.length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




11 


Value20ffset + value2Length > value2.length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
Value2 . length = 5 
Value20ffset = 3 
Value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




12 


Value2Length < 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




13 


Handler overflow Exception 

Call the appendArray ( ) with length of 

getCapacity {) -1 

appendTLV { ) 

Valuel. length = 256 

ValuelOffset = 

ValuelLength = 1 

Value2 . length = 256 

Value20ffset = 

Value2Length = 1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Bad parameter Exception 

Clear the handler 
appendTLV { ) 
Valuel . length = 256 
ValuelOffset = 
ValuelLength = 256 
Value2 . length = 256 
Value20ffset = 
Value2Length = 1 


ToolkitException.BAD_INPUT_PA 
RAMETER Is thrown 




15 


Bad parameter Exception 

appendTLV { ) 
Valuel. length = 256 
ValuelOffset = 
ValuelLength = 1 
Value2 . length = 256 
Value20ffset = 
Value2Length = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 






clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 






16 


Successful call 

appendTLV { ) 
tag = 04 

valuel = FF FE ... F8 
ValuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 






Clear the handler 






17 


Successful call 

appendTLV { ) 
tag = 04 

valuel = FF FE ... F8 
ValuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 








Call copyO method 








Compare handler 

CompareBuf fer = 04 10 FF FE ... FO 


Result is 00 




18 


Successful call 

appendTLV { ) 
tag = 85h 

valuel = 00 01 ... 07 
ValuelOffset = 2 
ValuelLength = 6 
value2 = 08 09 ... OF 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 
03 04 05 06 07 OA OB OC OD OE OF 


Result is 00 




19 


Successful call 

appendTLV { ) 
tag = 01 

valuel = 11 22 ... 88 
ValuelOffset = 2 
ValuelLength = 4 
value2 = 99 AA ... FF 00 
value20ffset = 2 
value2Length = 4 








Call copyQ method 








Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 
03 04 05 06 07 OA OB OC OD OE OF 01 08 33 
44 55 66 BB CC DD EE 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 




Clear the handler 






20 


Successful call 

appendTLV { ) 
tag = 04 

valuel = 00 01 ... 7F 
valuelOffset = 
valuelLength = 8 Oh 
value2 = 80 81 ... FC 
value20ffset = 
value2Length = 7Dh 








Call copyQ method 








Compare handler 

compareBuf fer = 04 81 FD 00 01...FC 


Result is 00 




21 


HANDLER_NOT_AVAILABLE exception 

Call post{) method, then appendTLV {) 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.4 Interface ProactiveHandler 
5.2.4.1 Method init 

Test Area Reference: Api_2_Pah_Init. 

5.2.4.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init {byte type, 

byte qualifier, 
byte dstDevice) 



5.2.4.1.1.1 



Normal execution 



5.2.4.1.1.2 
No requirements 

5.2.4.1.1.3 
No requirements 

5.2.4.1.2 

Test Source: 
Test Applet: 
Cap File: 



CRRNl: The init() method initializes the next Proactive command in the ProactiveHandler, with Command 
details and Device Identities TLV. The source device is always the UICC Card (81h). The Comprehension 
Required flags are set. 

CRRN2: The Command number may take any value between Olh and FEh. 

CRRN3: The init() method clears the ProactiveHandler before initializing it. 

CRRN4: No TLV is selected after a call to the method. 

CRRN5: The handler is not sent to the mobile by the init() method. 

Parameter errors 



Context errors 
Test area files 

Test_Api_2_Pah_Init.j ava. 
Api_2_Pah_Init_l .Java. 
api_2_p ah_init . c ap . 
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5.2.4.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 


N5 


1,3 



5.2.4.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactiveHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are identical 




2 


Verify the command number value 


Olh-FEh 




3 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 

Copy ProactiveHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 3h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are identical 




4 


Select the 1st TLV in the handler 
Call the init() method with any value 








Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 





5.2.4.2 Method initDisplaylext 

Test Area Reference: Api_2_Pah_Indt. 

5.2.4.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initDisplayText {byte qualifier, 

byte dcs, 
byte [] buffer, 
short offset, 
short length) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 



5.2.4.2.1.1 



Normal execution 



• CRRNl: The method shall build a DISPLAY TEXT proactive command in the ProactiveHandler, using 
qualifier, dcs and buffer parameters. Comprehension required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 
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• CRRN3: No TLV is selected after a call to the method. 

• CRRN4: The DISPLAY TEXT command is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

• CRRN6: If length is equal to zero, then the Text String TLV inserted in the command is a null text string TLV 
as defined in TS 101 267 [11]. 

5.2.4.2.1 .2 Parameter errors 

• CRRPl: The method shall throw NuUPointerException if buffer is null. 

• CRRP2: If offset or length or both would cause access outside array bounds, an 
ArraylndexOutOfBoundsException shall be thrown. 



5.2.4.2.1.3 



Context errors 



CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is too small 
to put the requested data. 



5.2.4.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.2.3 



Test area files 

Test_Api_2_Pah_Indt.j ava. 
Api_2_Pah_Indt_l .Java. 
api_2_pah_indt.cap. 

Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


N6 


16 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 



5.2.4.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

initDisplayText { ) 
buffer = NULL 


NuUPointerException is thrown 




2 


Offset > buffer.length 

initDisplayText { ) 
buffer = "Text" 

offset = 5 
length = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

initDisplayText { ) 
buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > buffer.length 

initDisplayText { ) 
buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


offset + length > buffer.length 


ArraylndexOutOfBoundsExceptio 






initDisplayText { ) 


n is thrown 






buffer = "Text" 








offset = 3 








length = 2 






6 


length < 


ArraylndexOutOfBoundsExceptio 






InitDisplayText { ) 


n is tlirown 






buffer = "Text" 








offset = 3 








length = -1 






7 


Successful call, buffer is the whole buffer 

initDisplayText { ) 
qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is tlirown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 




DISPLAY TEXT Proactive 




the end part 




command 




Send the command 








initDisplayText { ) 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextB" 




buffer = "12TextB" 








offset = 2 








length = 5 






10 


Successful call, buffer is part of a buffer with 




DISPLAY TEXT Proactive 




the first part 




command 




Send the command 








initDisplayText { ) 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextC" 




buffer = "TextC12" 








offset = 








length = 5 






11 


Successful call, buffer is part of a buffer 




DISPLAY TEXT Proactive 




Send the command 




command 




initDisplayText { ) 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextD34" 




Text = "TextD" 




offset = 2 








length = 5 






12 


Successful call, qualifier = 81h 




DISPLAY TEXT Proactive 




Send the command 




command 




initDisplayText { ) 








qualifier = 81h 




qualifier = 81h 




dcs = 4 




dcs = 4 




buffer = "TextE" 




Text = "TextE" 




offset = 








length = 5 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call, DCS=0 (7 bits) 




DISPLAY TEXT Proactive 




Send the command 




command 




initDisplayText { ) 








qualifier = 




qualifier = OOh 




dcs = 




dcs = 




buffer = "TextF" 




Text = "TextF" 




offset = 








length = 5 






14 


Successful call, DCS=8 (UCS2) 




DISPLAY TEXT Proactive 




Send the command 




command 




initDisplayText { ) 








qualifier = 




qualifier = OOh 




dcs = 8 




dcs = 8 




buffer = "TextG" 




Text = "TextG" 




offset = 








length = 5 






15 


Call the InitDisplayTextO method with any 




DISPLAY TEXT Proactive 




value 




command 




Then build and send a DISPLAY TEXT 








command 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextHTextH" 




buffer = "TextHTextH" 








offset = 








length = 10 






16 


Successful call, text length is zero 




DISPLAY TEXT Proactive 




Send the command 




command 




initDisplayText { ) 








qualifier = 




qualifier = OOh 




dcs = 4 




Text String TLV = 8D 




buffer = "TextHTextH" 








offset = 








length = 






17 


Select a TLV in the ProactiveHandler 


UNAVAILABLE_ELEMENT 






Call the InitDisplayTextO method 


ToolkitException is thrown by 






Call the getValueLengthO method 


getValueLengthO 




18 


Successful call, buffer length = 7Eh 




DISPLAY TEXT Proactive 




initDisplayText { ) 




command 




qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 7F 04 55 55... 




offset = 








length = 7Eh 






19 


Successful call, buffer length = 7Fh 




DISPLAY TEXT Proactive 




initDisplayText { ) 




command 




qualifier = 








dcs = 4 




Text String TLV = 8D 81 




buffer = "UUU..." 




80 04 55 55... 




offset = 








length = 7Fh 






20 


Successful call, buffer length = 240 




DISPLAY TEXT Proactive 




initDisplayText { ) 




command 




Qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 Fl 04 55 55... 




offset = 








length =24 






21 


Call the InitDisplayTextO method with a too 


HANDLER_OVERFLOW 






long buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 241 






22 


Call the InitDisplayTextO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 
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5.2.4.3 Method initGetlnkey 

Test Area Reference: Api_2_Pah_Ingk. 

5.2.4.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void initGetlnkey {byte qualifier, 

byte dcs, 
byte [] buffer, 
short offset, 
short length) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.4.3.1.1 Normal execution 

CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using qualifier, 
dcs and buffer parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initializes it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INKEY command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

CRRN6: If length is equal to zero, then the Text String TLV inserted in the command is a null text string TLV 
as defined in TS 101 267 [11]. 

5.2.4.3.1 .2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRPl : If offset or length or both would cause access outside array bounds, a 
ArraylndexOutOfBoundsException shall be thrown. 

5.2.4.3.1.3 Context errors 

• CRRCl : A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 

5.2.4.3.2 Test area files 

Test Source: Test_Api_2_Pah_Ingk.java. 
Test Applet: Api_2_Pah_Ingk_l.java. 

Cap File: api_2_pah_ingk.cap. 
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5.2.4.3.3 



Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


N6 


16 


P1 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 



5.2.4.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

initGetlnkey {) 
buffer = NULL 


NullPointerException is thrown 




2 


Offset > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 5 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

initGetlnkey {) 
buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

initGetlnkey {) 
buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

initGetlnkey {) 
qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 
the end part 

initGetlnkey {) 
qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextB" 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Successful call, buffer is part of a buffer with 




GET INKEY Proactive 




the first part 




command 




initGetlnkey { ) 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "TextC12" 




Text = "TextC" 




offset = 








length = 5 






11 


Successful call, buffer is part of a buffer 




GET INKEY Proactive 




Send the command 




command 




initGetlnkey {) 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextD34" 




Text = "TextD" 




offset = 2 








length = 5 






12 


Successful call, qualifier = 81h 




GET INKEY Proactive 




initGetlnkey {) 




command 




qualifier = 81h 








dcs = 4 




qualifier = 81h 




buffer = "TextE" 




dcs = 4 




offset = 




Text = "TextE" 




length = 5 






13 


Successful call, DCS=0 (7 bits) 




GET INKEY Proactive 




initGetlnkey {) 




command 




qualifier = 








dcs = 




qualifier = OOh 




buffer = "TextF" 




dcs = 




offset = 




Text = "TextF" 




length = 5 






14 


Successful call, DCS=8 (UCS2) 




GET INKEY Proactive 




initGetlnkey { ) 




command 




qualifier = 








dcs = 8 




qualifier = OOh 




buffer = "TextG" 




dcs = 8 




offset = 




Text = "TextG" 




length = 5 






15 


Call the initGetlnkeyO method with any value 




GET INKEY Proactive 




Then build and send a GET INKEY command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "TextHTextH" 




dcs = 4 




offset = 




Text = "TextHTextH" 




length = 10 






16 


Successful call, text length is zero 




GET INKEY Proactive 




Send the command 




command 




initGetlnkeyO 








qualifier = 




qualifier = OOh 




dcs = 4 




Text String TLV = 8D 




buffer = "TextHTextH" 








offset = 








length = 






17 


Select a TLV in the ProactiveHandler 


UNAVAILABLE_ELEMENT 






Call the InitGetlnkeyO method 


ToolkitException is thrown by 






Call the getValueLengthO method 


getValueLengthO 




18 


Successful call, buffer length = 7Eh 




GET INKEY Proactive 




initGetlnkeyO 




command 




qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 7F 04 55 55... 




offset = 








length = 7Eh 






19 


Successful call, buffer length = 7Fh 




GET INKEY Proactive 




initGetlnkeyO 




command 




qualifier = 








dcs = 4 




Text String TLV = 8D 81 




buffer = "UUU..." 




80 04 55 55... 




offset = 








length = 7Fh 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Successful call, buffer length = 240 




GET INKEY Proactive 




initGetlnkeyO 




command 




Qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 Fl 04 55 55... 




offset = 








length =24 






21 


Call the InitGetlnkeyO method with a too long 


HANDLER_OVERFLOW 






buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 241 






22 


Call the InitGetlnkeyO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 



5.2.4.4 Method initGetlnput 

Test Area Reference: Api_2_Pah_Ingp. 

5.2.4.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnput {byte qualifier, 

byte dcs, 
byte [] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.4.4.1.1 



Normal execution 



CRRNl: The method shall build a GET INPUT proactive command in the ProactiveHandler, using qualifier, 
dcs, buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

CRRN2: A call to this method clears the handler then initializes it. 

CRRN3: No TLV is selected after a call to the method. 

CRRN4: The GET INPUT command is not sent by the method. 

CRRN5: The Command Number may take any value between Olh and FEh. 

CRRN6: If length is equal to zero, then the Text String TLV inserted in the command is a null text string TLV 
as defined in TS 101 267 [11]. 

5.2.4.4.1 .2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRP2: If offset or length or both would cause access outside array bounds, a 
ArraylndexOutOfBoundsException shall be thrown. 



5.2.4.4.1.3 



Context errors 



CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 
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5.2.4.4.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.4.3 



Test area files 

Test_Api_2_Pah_Ingp.j ava. 
Api_2_Pah_Ingp_ 1 .j ava. 
api_2_pah_ingp.cap. 

Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


N6 


16 


P1 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 



5.2.4.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

initGetlnput {) 
buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

initGetlnkey { ) 
buffer = "Text" 
offset = 5 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

initGetlnkey {) 
buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

initGetlnkey {) 
buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

initGetlnkey {) 
buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

initGetlnkey { ) 
qualifier = 
cJcs = 4 

buffer = "TextA" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Send the command 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 
Min Length = OOh 
Max Length = FFh 


9 


Successful call, buffer is part of a buffer with 




GET INPUT Proactive 




the end part 




command 




Send the command 








initGetlnkey { ) 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextB" 




buffer = "12TextB" 




Min Length = lOh 




offset = 2 




Max Length = FFh 




length = 5 








minRespLength = lOh 








maxRespLength = FFh 






10 


Successful call, buffer is part of a buffer with 




GET INPUT Proactive 




the first part 




command 




Send the command 








initGetlnkey { ) 




qualifier = OOh 




qualifier = 




dcs = 4 




dcs = 4 




Text = "TextC" 




buffer = "TextC12" 




Min Length = FFh 




offset = 




Max Length = FFh 




length = 5 








minRespLength = FFh 








maxRespLength = FFh 






11 


Successful call, buffer is part of a buffer 




GET INPUT Proactive 




Send the command 




command 




initGetlnkey { ) 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextD34" 




Text = "TextD" 




offset = 2 




Min Length = OOh 




length = 5 




Max Length = OOh 




minRespLength = OOh 








maxRespLength = OOh 






12 


Successful call, qualifier = 81h 




GET INPUT Proactive 




initGetlnkey {) 




command 




qualifier = 81h 








dcs = 4 




qualifier = 81h 




buffer = "TextE" 




dcs = 4 




offset = 




Text = "TextE" 




length = 5 




Min Length = OOh 




minRespLength = OOh 




Max Length = lOh 




maxRespLength = lOh 






13 


Successful call, DCS=0 (7 bits) 




GET INPUT Proactive 




initGetlnkey {) 




command 




qualifier = 








dcs = 




qualifier = OOh 




buffer = "TextF" 




dcs = 




offset = 




Text = "TextF" 




length = 5 




Min Length = lOh 




minRespLength = lOh 




Max Length = lOh 




maxRespLength = lOh 






14 


Successful call, DCS=8 (UCS2) 




GET INPUT Proactive 




initGetlnkey {) 




command 




qualifier = 








dcs = 8 




qualifier = OOh 




buffer = "TextG" 




dcs = 8 




offset = 




Text = "TextG" 




length = 5 




Min Length = OOh 




minRespLength = OOh 




Max Length = FFh 




maxRespLength = FFh 







ETSI 



Release 6 



208 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


15 


Call the initGetlnputO method with any value 




GET INPUT Proactive 




Then build and send a GET INPUT command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "TextHTextH" 




dcs = 4 




offset = 




Text = "TextHTextH" 




length =10 




Min Length = OOh 




minRespLength = OOh 




Max Length = lOh 




maxRespLength = lOh 






16 


Successful call, text length is zero 




GET INPUT Proactive 




Send the command 




command 




initGetlnkey {) 








qualifier = 




qualifier = OOh 




dcs = 4 




Text String TLV = 8D 




buffer = "TextHTextH" 




Min Length = OOh 




offset = 




Max Length = lOh 




length = 








minRespLength = OOh 








maxRespLength = lOh 






17 


Select a TLV in the ProactiveHandler 


UNAVAILABLE_ELEMENT 






Call the initGetlnputO method 


ToolkitException is thrown by 






Call the getValueLengthO method 


getValueLengthO 




18 


Successful call, buffer length = 7Eh 




GET INPUT Proactive 




initGetlnkey {) qualifier = 




command 




dcs = 4 








buffer = "UUU..." 




Text String TLV = 




offset = 




8D 7F 04 55 55... 




length = 7Eh 




Min Length = OOh 




minRespLength = OOh 




Max Length = lOh 




maxRespLength = lOh 






19 


Successful call, buffer length = 7Fh 




GET INPUT Proactive 




initGetlnkey { ) 




command 




qualifier = 








dcs = 4 




Text String TLV = 8D 81 




buffer = "UUU..." 




80 04 55 55... 




offset = 




Min Length = OOh 




length = 7Fh 




Max Length = lOh 




minRespLength = OOh 








maxRespLength = lOh 






20 


Successful call, buffer length = 236 




GET INPUT Proactive 




initGetlnkey { ) 




command 




Qualifier = 








dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 ED 04 55 55... 




offset = 








length = 236 








minRespLength = OOh 








maxRespLength = lOh 
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Call the initGetlnputO method with a too long 


HANDLER_OVERFLOW 






buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 237 








minRespLength = OOh 








maxRespLength = lOh 
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Call the InitGetlnputO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 
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5.2.4.5 Method send 

Test Area Reference: Api_2_Pah_Send. 

5.2.4.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte send{) 

5.2.4.5.1.1 Normal execution 

• CRRNl: The send() method send the current proactive command to the mobile. 

• CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 

• CRRN3: The handler remains unchanged after a call to send() method until the use of initXX() or 
appendTLV(). 

• CRRN4: There is no invocation of select() or deselect() method. 

• CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 

5.2.4.5.1 .2 Parameter errors 
No requirements. 

5.2.4.5.1 .3 Context errors 

• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is the Result Comprehension 
TLV is missing in Terminal Response. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Comprehension TLV in Terminal Response. 

• CRRC3: A ToolkitException.COMMAND_NOT_ALLOWED shall be thrown if the proactive command to be 
sent is not allowed by the CAT Runtime Environment. 

• CRRC4: A ToolkitException.COMMAND_NOT_ALLOWED shall be thrown if one parameter of the 
proactive command to be sent is not allowed by the CAT Runtime Environment. 



5.2.4.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.5.3 



Test area files 

Test_Api_2_Pah_Send.j ava. 
Api_2_Pah_Send_l .Java. 
api_2_pah_send.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1, 3, 5,7,9, 10, 11, 12, 13, 14 


N2 


2,4, 6,8, 14 


N3 


12 


N4 


13 


N5 


checked in the CAT Runtime Environment test : Ore Api Tran (test case 1) 


C1 


15 


C2 


16 


C3 


checl<ed in the CAT Runtime Environment test : Fwk Pes Pcco (test case 1) 


C4 


checked in the CAT Runtime Environment test : Fwk Pes Pcco (test cases 2 to 3) 
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5.2.4.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = 00 

Result TLV = 03 01 00 {command performed 
successfully) 


Result of sendQ is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01, 
without Additional information on result 

Result TLV = 03 01 01 {command performed 
with partial comprehension) 


Result of sendQ is 01 h 




5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 {command 
performed with partial comprehension) 


Result of sendQ is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 {Missing 
information) 


Result of sendQ is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 


10 


Build and send a 80h byte command (DISPLAY 
TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 80 
Text String TLV = 8D 75 
04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length =24 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 
Fl 04 55 55... 


12 


Verify that the Proactive Handler is not 

modified after a send() 

Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 

Compare source and destination 


Source and destination are 
identical 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Build and send a DISPLAY TEXT command 

Verify there is no invocation of select() or 

deselectO method. 




DISPLAY TEXT Proactive 
command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 


Result of sendQ is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result 
Comprehension TLV 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown by sendQ 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result byte 
in the Comprehension TLV 

Result TLV = 03 00 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown by 
sendQ 





5.2.4.6 Method getLength 

Test Area Reference Api_2_Pah_Glen. 

5.2.4.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength {) 

throws ToolkitException 

5.2.4.6.1.1 Normal execution 

• CRRN 1 : returns the length in bytes of the TLV list. 

5.2.4.6.1 .2 Parameter errors 
No requirements. 

5.2.4.6.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.6.3 



Test area files 

Test_Api_2_Pah_Glen.j ava 
Api_2_Pah_Glen_l .Java. 
api_2_pah_glen.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


CI 


Does not apply for Proactive Handler 
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5.2.4.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength { ) 


Result of getLengthO is 




2 


Call the initO method 

getLength { ) 


Result of getLengthO is 9 




3 


Call the InitDisplayTextO method, with buffer 
length = 240 

getLength { ) 


Result of getLengthO is 253 




4 


Build a 7Fh Proactive Handler 

getLength { ) 


Result of getLengthO is 7Fh 




5 


Build a 80h Proactive Handler 

getLength { ) 


Result of getLengthO is 80h 





5.2.4.7 Method copy 

Test Area Reference Api_2_Pah_Copy. 



5.2.4.7.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy {byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.4.7.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.4.7.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.4.7.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.7.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Pah_Copy.j ava. 
Api_2_Pah_Copy_l .j ava. 
api_2_pah_copy.cap. 
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5.2.4.7.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2,3,4,5,6 


P3 


7 


C1 


Does not apply for ProactiveHandler 



5.2.4.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the initO method 








DstOffset > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

copy {) 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


DstLength > dstBuffer.length 

copy { ) 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy { ) 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy { ) 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy { ) 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy { ) 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy {) 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy { ) 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 
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5.2.4.8 Method findTLV 

Test Area Reference Api_2_Pah_Find. 

5.2.4.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte findTLV {byte tag, 

byte occurrence) 
throws ToolkitException 

5.2.4.8.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.4.8.1 .2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.4.8.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.8.4 



Test area files 

Test_Api_2_Pah_Find.j ava. 
Api_2_Pah_Find_ Lj ava. 
api_2_pah_find.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for Proactive Handler 
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5.2.4.8.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








Invalid input parameter 

findTLVO 
Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 


Call the initO method 








Search 1st TLV 

findTLVO 
Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




8 


Search a tag with wrong occurrence 

findTLVO 
Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

findTLVO 
Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





5.2.4.9 Method getValueLength 

Test Area Reference Api_2_Pah_Gvle. 

5.2.4.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 



5.2.4.9.1.1 



Normal execution 



CRRN 1 : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 
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5.2.4.9.1.2 

No requirements. 

5.2.4.9.1.3 



Parameter errors 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.4.9.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.9.3 



Test area files 

Test_Api_2_Pah_Gvle.java. 
Api_2_Pah_Gvle_l .Java. 
api_2_pah_g vie. cap . 

Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


01 


Does not apply for Proactive Handler 


C2 


1 



5.2.4.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 








getValueLength { ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Call the appendTLVO method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is OOh 




3 


Call the InitDisplayTextO method 

length = 1 {+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 02h 




4 


Call the InitDisplayTextO method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 7Fh 




5 


Call the InitDisplayTextO method 

length = 7Fh {+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 80h 




6 


Call the InitDisplayTextO method 

length = FOh {maximum text length) 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is F1h 
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5.2.4.10 Method getValueByte 

Test Area Reference Api_2_Pah_Gvby. 

5.2.4.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte {short valueOffset) 
throws ToolkitException 



5.2.4.10.1.1 



Normal execution 



• CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 

(1 byte). 



5.2.4.10.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.4.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.10.3 



Test area files 

Test_Api_2_Pah_Gvby.j ava. 
Api_2_Pah_Gvby_l .Java. 
api_2_pah_gvby.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for Proactive Handler 


C2 


1 



5.2.4.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueByte(O) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




5 


initDisplayTextO 

buffer = 00 01 ... 7D 

length = 7Eh 

Search TLV ODh {Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


InitDisplayTextO 

buffer = 00 01 ... 7D 7E 

length = 7Fh 

Search TLV ODh {Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 




8 


InitDisplayTextO 

buffer = 00 01 ... EF 

length = FOh 

Search TLV ODh {Text String TLV) 








getValueByte(FO) 


Result is EFh 





5.2.4.11 Method copyValue 

Test Area Reference Api_2_Pah_Cpyv 

5.2.4.1 1.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue {short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.4.11.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.4.11.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.4.11.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 
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5.2.4.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.11.3 



Test area files 

Test_Api_2_Pah_Cpy v.j ava. 

Api_2_Pah_Cpyv_l.java. 

api_2_pah_cpyv.cap. 

Test coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for Proactive Handler 


C2 


11 



5.2.4.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








copyValue {) with a null dstBuffer 


NullPointerException is thrown 




2 


initDisplayTextQ with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

copyValue { ) 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
copyValue { ) 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


[Select Text String TLV] 

dstLength > Text String length 
copyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + dstLength > Text String 

length 

copyValue { ) 

valueOffset = 2 

dstBuffer. length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








copyValueQ 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 




12 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Successful call 

copyValue { ) 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue { ) 
valueOffset = 2 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





5.2.4.12 Method compareValue 

Test Area Reference Api_2_Pah_Cprv. 



5.2.4.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue {short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws Java. lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 
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5.2.4.12.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.4.12.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.4.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.12.3 



Test area files 

Test_Api_2_Pah_Cprv.j ava. 
Api_2_Pah_Cprv_ Lj ava. 
api_2_pah_cprv. cap . 

Test coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for Proactive Handler 


C2 


11 
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5.2.4.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue { ) 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 
Select Text String TLV 








valueOffset > Text String Length 

compareValue { ) 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
compareValue { ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
compareValue { ) 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

compareValue { ) 

valueOffset = 2 

compareBuffer.length = 15 

compareOffset = 

compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareValueQ 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue { ) 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

compareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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5.2.4.13 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference Api_2_Pah_Facyb_Bs. 

5.2.4.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short f indAndCopyValue {byte tag, 

byte [] dstBuffer, 
short dstOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.4.13.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.4.13.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.4.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.4.13.2 Test area files 

Test Source: Test_Api_2_Pah_Facyb_Bs.java. 
Test Applet: Api_2_Pah_Facyb_Bs_Ljava. 

Cap File: api_2_pah_facyb_bs.cap. 

5.2.4.13.3 Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Handler 
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5.2.4.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 








dstOffset > dstBuffer.length 

f indAndCopyValue { ) 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

f IndAndCopyValue { ) 
DstBuffer.length = 20 

DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


initDisplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

f IndAndCopyValue { ) 
Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndCopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = 2 


Result of findAndCopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
DC OD OE OF 55 


Result is OOh 




11 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








append a 2nd Text String TLV 








Successful call 

f IndAndCopyValue { ) 
tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 





ETSI 



Release 6 



226 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


13 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

f indAndCopyValue { ) 
tag = 8Dh 

dstBuffer. length = 17 
dstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag BFh) 

f IndAndCopyValue { ) 
tag = 8Fh 

dstBuffer. length = 16 
dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOli 





5.2.4.14 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference Api_2_Pah_Facybbs_Bss. 

5.2.4.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

Java . lang.ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.4.14.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.4.14.1.2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 
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• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.4.14.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.4.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.14.3 



Test area files 

Test_Api_2_Pah_Facybbs_Bss.java. 
Api_2_Pah_Facybbs_Bss_l .Java. 
api_2_pah_facybbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20, 21,22, 23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


24 


CI 


Does not apply for ProactiveHandler 



5.2.4.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextQ with length = 15 








dstOffset > dstBuffer.length 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 6 

dstLength = 


ArraylndexOutOfBoundsExceptIo 
n is tlirown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


dstLength >dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

f indAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

f indAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


initDisplayTextO with length = 5 








valueOffset > Text String Length 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 7 

dstBuffer. length = 15 

dstOffset = 

dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue { ) 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 2 
dstBuffer. length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




12 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 20 

dstOffset = 3 

dstLength = 12 


Result of findAndCopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 {no specific 

DCS byte) 








Successful call 

f indAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO is 
17 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 2 

valueOffset = 

dstBuffer. length = 6 

dstOffset = 

dstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOli 




20 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue { ) 
tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCopyValue { ) 
tag = BFh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 16 
dstOffset = 
dstLength = 16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOli 




24 


Invalid parameter 

f IndAndCopyValue { ) 
occurrence = 


Tooll<itException.BAD_INPUT_PA 
RAMETER is thrown 





5.2.4.15 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference Api_2_Pah_Facrb_Bs. 

5.2.4.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte [] compareBuffer, 
short compareOffset) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.4.15.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 
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• CRRN3 : if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -1 . 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.4.15.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 



5.2.4.15.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 



5.2.4.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.15.3 



Test area files 

Test_Api_2_Pah_Facrb_Bs.java. 
Api_2_Pah_Facrb_B s_ 1 .j ava. 
api_2_pah_facrb_bs.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Handler 



5.2.4.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = ODh 

compareBuffer.length =20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


compareOffset + length > 
compareBuffer.lengtfi 

f indAncJCompareValue { ) 
compareBuf fer. length =20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = 03h 


Tooll<itException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


Tooll<itException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

f incLAncJCompareValue { ) 
tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength { ) 


Result is 17 




9 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f indAndCompareValue { ) 
compareOffset = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f indAncJCompareValue { ) 
compareOffset = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOffset = 2 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

f indAndCompareValue { ) 

compareOffset = 2 


Result is +1 




15 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue { ) 
tag = 8Dh 

compareBuf fer. length = 17 
compareOffset = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue { ) 
tag = 8Fh 

compareBuf fer . length = 16 
compareOffset = 


Result is OOh 




17 


Initialize compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue { ) 
tag = 8Fh 

compareBuf fer . length = 16 
compareOffset = 


Result is +1 





5.2.4.16 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference Api_2_Pah_Facrbbs_Bss. 



5.2.4.16.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f IndAndCompareValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 



5.2.4.16.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 
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• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.4.16.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.4.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.4.16.2 Test area files 

Test Source: Test_Api_2_Pah_Facrbbs_Bss.java. 
Test Applet: Api_2_Pah_Facrbbs_Bss_Ljava. 

Cap File: api_2_pah_facrbbs_bss.cap. 

5.2.4. 1 6.3 Test coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16,19 


N6 


23,24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


C1 


Does not apply for Proactive Handler 
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5.2.4.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


initDisplayTextQ with length = 15 








compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 








valueOffset > Text String Length 

f IndAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue { ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue { ) 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue { ) 
valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue { ) 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

getValueLength { ) 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue { ) 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuffer. length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue { ) 
tag = BFh, occurrence = 1 
valueOffset = 
compareBuffer. length = 16 
compareOf f set = 
compareLength = 16 


Result is OOh 




25 


Initialize compareBuffer 

compareBuffer =0099 02 ... OF 








findAndCompareValueO 

f IndAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





5.2.4.17 Method appendArray 

Test Area Reference: Api_2_Pah_Apda. 

5.2.4.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendArray {byte [] buffer, 

short offset, 
short length) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 
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5.2.4.17.1.1 Normal execution 

• CRRN 1 : appends a buffer into the Edithandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

5.2.4.1 7.1 .2 Parameter errors 

• CRRPl: if buffer is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.4.17.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.4.17.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.17.3 



Test area files 

Test_Api_2_Pah_Apda.j ava. 
Api_2_Pah_Apda_l .Java. 
api_2_pah_apda.cap. 

Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


PI 


1 


P2 


2,3,4,5,6 


CI 


7 


C2 


Does not apply for ProactiveHandler 



5.2.4.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null buffer 

appendArray { ) 


NullPointerException is thrown 




2 


offset > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = S 
length = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


Offset < 

appendArray { ) 
buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Offset + length > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


length < 

appenciArray { ) 
buffer. length = 5 

offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

appenciArray { ) 

buffer. length = getCapacity { ) +1 

offset = 

length = getCapacity {) +1 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




8 


Initialize handler 








Select Command Details TLV 








Successful call 

appenciArray { ) 
buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




9 


Clear the handler 








Successful call 

appenciArray { ) 
buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 


Result of 

javacard.frameworl<.Util.arrayCom 
pareO is OOh 




10 


Successful call 

appenciArray { ) 
buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyQ method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




11 


Successful call 

appenciArray { ) 
buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyQ method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




12 


Clear the handler 








Successful call 

appenciArray { ) 
buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 
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5.2.4.1 8 Method appendTLV(byte tag, byte value) 

Test Area Reference: Api_2_Pah_Aptlbb. 

5.2.4.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV (byte tag, byte value) 
throws ToolkitException 

5.2.4.18.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.4.18.1.2 
No requirements. 

5.2.4.18.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.4.18.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.18.3 



Test area files 

Test_Api_2_Pah_Aptlbb.java. 
Api_2_Pah_Aptlbb_l .Java. 
api_2_pah_aptlbb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


01 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call append ArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVQ method 


ToolkltException.HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh 








Call copyQ method 








Compare the arrays 

compareBuf fer = 84 01 00 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
value = FEh 








Call copvO method 








Compare the arrays 

compareBuf fer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Utll.arrayCom 
pareO is OOh 




5 


Clear the handler 
Call append ArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 

Successful call 

appendTLV { ) 
tag = 84h 
value = OOh 

Call getLengthO method 
Call copyO method 
Compare the array 

compareBuffer = 00 81 F7 03 04 ... F9 84 01 
00 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





5.2.4.1 9 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: Api_2_Pah_Aptlbbb. 

5.2.4.19.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte valuel, 
byte value2) 
throws ToolkitException 

5.2.4.19.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.19.1.2 Parameter errors 
No requirements. 

5.2.4.19.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 
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5.2.4.19.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.19.3 



Test area files 

Test_Api_2_Pah_Aptlbbb.java. 

Api_2_Pah_Aptlbbb_l.java. 

api_2_pah_aptlbbb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVQ method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyQ method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyQ method 








Compare handler 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 
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5.2.4.20 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: Api_2_Pah_Aptlb_Bss. 

5.2.4.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV{byte tag, 

byte [] value, 
short valueoffset, 
short valuelength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.4.20.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.20.1 .2 Parameter errors 

• CRRPl: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.4.20.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.4.20.2 Test area files 

Test Source: Test_Api_2_Pah_Aptlb_Bss.java. 
Test Applet: Api_2_Pah_Aptlb_Bss_l.java. 

Cap File: api_2_pah_aptlb_bss.cap. 

5.2.4.20.3 Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for Proactive Handler 


C3 


8 
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5.2.4.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 

appendTLV { ) 


NullPointerException is thrown 




2 


valueOffset > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


valueOffset < 

appendTLV { ) 
value . length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


valueLength > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

appendTLV { ) 
value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




7 


Handler overflow exception 

Call the appendArray { ) method, length = 

getCapacity { ) -1 

appendTLV { ) 

value.length = 254 

valueOffset = 

valueLength = 254 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLV { ) 
value.length = 256 
valueOffset = 
valueLength = 256 


ToolkJtException.BAD_INPUT_PA 
RAMETER is thrown 




9 


Initialize handler 








Select Command Details TLV 








Successful call 

appendTLV { ) 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Verify Current TLV: Call getValueLengthQ 


Result Is 03h 




10 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Call copyQ method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 


Result of 

javacard.framework.Utll.arrayCom 
pare{) is OOh 




11 


Successful call 

appendTLV { ) 

tag = 85h 

value = 01 ... 7 

valueOffset = 2 

valueLength = 6 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Successful call 

appendTLV { ) 

tag = 01 

value = 11 22 ... 88 

valueOffset = 2 

valueLength = 4 








Call copyQ method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




13 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

value = 00 01 ... 7F 

valueOffset = 

valueLength = 80h 








Call copvO method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Utll.arrayCom 
pareO is OOh 




14 


Clear the handler 

Successful call 

appendTLV { ) 

tag = 04 

value = 00 01 ... F9 

valueOffset = 

valueLength = 250 

Call getLengthO method 

Call copyQ method 

Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





5.2.4.21 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 

short value2length) 

Test Area Reference: Api_2_Pah_Aptlbb_Bss. 

5.2.4.21.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte valuel 
byte [] value2 , 
short value2of f set , 
short value21ength) 
throws Java . lang.NullPointerException, 

Java . lang.ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.4.21 .1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.21.1.2 Parameter errors 

• CRRPl: if value2 is null, a Java. lang.NullPointerException is thrown. 
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• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.4.21.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.4.21.2 Test area files 

Test Source: Test_Api_2_Pah_Aptlbb_Bss.java. 
Test Applet: Api_2_Pah_Aptlbb_Bss_l.java. 

Cap File: api_2_pah_aptlbb_bss.cap. 



5.2.4.21.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


01 


7 


C2 


Does not apply for Proactive Handler 


03 


8 



5.2.4.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 

appendTLV { ) 


NullPointerException is thrown 




2 


value20ffset > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

appendTLV { ) 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

appendTLV { ) 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Handler overflow exception 

Call the appendArray { ) method, length = 

getCapacity { ) - 1 

appendTLV { ) 

value2 . length = 254 

value20ffset = 

value2Length = 254 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLV { ) 
value2 . length = 256 
value20ffset = 
value2Length = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




9 


Initialize handler 








Select Command Details TLV 








Successful call 

appendTLV { ) 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Call copyO method 








Compare the arrays 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result of 

javacard.frameworl<.Util.arrayCom 
pare{) is OOh 




11 


Successful call 

appendTLV { ) 
tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

CompareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.frameworl<.Util.arrayCom 
pare{) is OOh 




12 


Successful call 

appendTLV { ) 
tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyQ method 








Compare the arrays 

CompareBuf fer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result of 

javacard.frameworl<.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare the arrays 

CompareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.frameworl<.Util.arrayCom 
pare{) is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Clear the handler 








Successful call 

appencJTLV { ) 
tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





5.2.4.22 Method clear 

Test Area Reference: Api_2_Pah_Cler. 

5.2.4.22.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public voicJ clear {) 

throws ToolkitException 

5.2.4.22.1.1 Normal execution 

• CRRN 1 : Clears the TLV list of an EditHandler. 

• CRRN2: Resets the current TLV selected. 



5.2.4.22.1.2 
No requirements. 

5.2.4.22.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.4.22.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.22.3 



Test area files 

Test_Api_2_Pah_Cler.j ava. 
Api_2_Pah_Cler_l .Java. 
api_2_pah_cler.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


CI 


Does not apply for Proactive Handler 
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5.2.4.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ELEMENT 
is thrown 





5.2.4.23 Method getCapacity 

Test Area Reference: Api_2_Pah_Gcap. 

5.2.4.23.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity { ) 

5.2.4.23.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 



5.2.4.23.1.2 
No requirements. 

5.2.4.23.1.3 
No requirements. 

5.2.4.23.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.23.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Pah_Gcap.java. 
Api_2_Pah_Gcap_l .Java. 
api_2_pah_gcap . cap . 

Test coverage 



CRR number 


Test case number 


N1 


1 
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5.2.4.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


ProactivehHandler available 

1- Send envelope Menu Selection 

2- The applet calls getTheHandler { ) 

3- The applet calls getCapacity { ) on the 
ProactiveHandler 

4- The applet fills the handler with the 
maximum capacity, using appendTLVO method 

5- The applet calls clear {) on the 
proactive handler 

6- The applet fills the handler with the 
maximum capacity plus one, using 
appendTLV { ) method 


1 - Applet is triggered 

2- No exception is thrown 

3- No exception is tlirown, the 
capacity shall not be null 

4- No exception is thrown 

5- No exception is thrown 

6- HANDLER_OVERFLOW 
exception is thrown 





5.2.4.24 Method initCloseChannel 

Test Area Reference: Api_2_Pah_Icch. 
5.2.4.24.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initCloseChannel {byte bChannelldentif ier) 

5.2.4.24.1.1 Normal execution 

• CRRNl: The method shall build a Close Channel Proactive command, using Channel Identifier. 
Comprehension Required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it with Close Channel Proactive command. 

• CRRN3: After the method invocation, no TLV is selected. 

• CRRN4: The Close Channel Proactive command is not sent by the method. 

5.2.4.24.1 .2 Parameter errors 
No requirements. 

5.2.4.24.1.3 
No requirements. 



5.2.4.24.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.24.3 



Context errors 
Test area files 

Test_Api_2_Pah_Icch.j ava. 
Api_2_Pah_Icch_l .Java. 
api_2_pah_icch.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


N3 


3 


N4 


2,4 
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5.2.4.24.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Appletl is installed with maximum number 
of channel = 01. 






1 


Call initCloseChannelO method 

1- Call ProactiveHandler . init { ) method to 
open a Channel. 

Call ProactiveHandler . send { ) method. 

2- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 

3- Call 

ProactiveHandler . initCloseChannel { ) 
method with Channel Id = 01. 

4- Call ProactiveHandler . send { ) method. 

5- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 


2- Appletl is triggered. 
5- Appletl is not triggered. 


1- OPEN CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 
the UIGC with Channel Id = 
01. 

4- CLOSE CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
CLOSE CHANNEL is sent to 
the UICC. 


2 


Call the InitCloseChannel () method with any 

value then build and send a CLOSE CHANNEL 

command 

1- Call ProactiveHandler . init { ) method to 
open a Channel and 
ProactiveHandler . send { ) method. 

2- Call 

ProactiveHandler . initCloseChannel { ) 
method with Channel Id = 2 

3- Call 

ProactiveHandler . initCloseChannel { ) 
method with the Channel Id = 1 . 

4- Call send{) method. 

5- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 


5- Appletl is not triggered. 


1- OPEN CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 
the UICC with Channel Id = 
01. 

4- CLOSE CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
CLOSE CHANNEL is sent to 
the UICC. 


3 


Select a TLV in the ProactiveHandler 
Call the InitCloseChannel () method 

1- Call ProactiveHandler . init { ) method to 
open a Channel and call the 
ProactiveHandler . send { ) method. 

Select 1st TLV of the Proactive Handler. 

2- Call 

ProactiveHandler . initCloseChannel { ) 
method with Channel Id = 01. 

3- Call ViewHandler .getValueLengthO 
method . 

4- Call ProactiveHandler . send { ) method. 


3- UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthQ method. 


1- OPEN CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 
the UICC with Channel Id = 
01. 

4- CLOSE CHANNEL 
proactive command is 
fetched. 

TERMINAL RESPONSE of 
CLOSE CHANNEL is sent to 
the UICC. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Call the initCloseChannelQ without sending 




1- OPEN CHANNEL 




the command 




proactive command is 




1- Call ProactiveHandler . init { ) method to 


3- Appletl is triggered. 


fetched. 




open a Channel and call the 
ProactiveHandler . send { ) method. 




TERMINAL RESPONSE of 
OPEN CHANNEL is sent to 




2- Call 




the UICC with Channel Id = 




ProactiveHandler . initCloseChannel { ) 




01. 




method with Channel Id = 01 without 








ProactiveHandler . send { ) . 








3- Send an 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 
Envelope . 




No proactive command shall 
be sent. Expected status is 
'9000' 



5.2.4.25 Method getValueShort 

Test Area Reference: Api_2_Pah_Gvsh. 

5.2.4.25.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort {short valueOffset) 
throws ToolkitException 



5.2.4.25.1.1 



Normal execution 



CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.4.25.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.4.25.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.4.25.2 Test area files 

Specific triggering: None 

Test Source: Test_Api_2_Pah_Gvsh.java. 
Test Applet: Api_2_Pah_Gvsh_l.java. 

Cap File: api_2_pah_gvsh.cap. 



5.2.4.25.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for Proactive Handler 


C2 


1 
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5.2.4.25.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueShort(O) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueShort(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueShort(l) 


Result is FFIi FEh (type, qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueShort(O) 


Result is 81 h FDh (Source, 
Destination) 




5 


initDisplayTextO 

buffer = 00 01 ... 7D 
length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




6 


InitDisplayTextO 

buffer = 00 01 ... 7D 7E 
length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




7 


getValueShort(7E) 


Result is 7Dh 7Eh 




8 


initDisplayTextO 

buffer = 00 01 ... EF 
length = FOh 

Search TLV ODh (Text String TLV) 








getValueShort(EF) 


Result is EEh EFh 





5.2.4.26 Method appendTLV(byte tag, byte valuel , short value2) 

Test Area Reference: Api_2_Pah_Aptlbbs. 
5.2.4.26.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV{byte tag, 

byte valuel, 
short value2) 
throws ToolkitException 

5.2.4.26.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (3-byte element(l -byte, 1 -short)). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.4.26.1.2 
No requirements. 



Parameter errors 
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5.2.4.26.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.4.26.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Pah_Aptlbbs.java. 
Test Applet: Api_2_Pah_Aptlbbs_l.java. 

Cap File: api_2_pah_aptlbbs.cap. 



5.2.4.26.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.26.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call copyQ method 








Compare the arrays 

compareBuf fer = 84 03 00 01 02 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh 
value2 = FDh FCh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 03 00 01 02 01 03 FE 
FD FC 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Clear the handler 








Call appendArrayO 

length = 248 

buffer = 00 81 F5 03 04 ... F7 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F5 03 04 ... F7 84 03 
00 01 02 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





5.2.4.27 Method appendTLV(byte tag, short value) 

Test Area Reference: Api_2_Pah_Aptlbs. 

5.2.4.27.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

short value) 
throws ToolkitException 

5.2.4.27.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte or 1-short element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.27.1 .2 Parameter errors 
No requirements. 

5.2.4.27.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.4.27.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Pah_Aptlbs.java. 
Test Applet: Api_2_Pah_Aptlbs_l.java. 

Cap File: api_2_pah_aptlbs.cap. 
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5.2.4.27.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.27.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVQ method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh Olh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
value = FEh FFh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FF 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




5 


Clear the handler 
Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 

Successful call 

appendTLV { ) 
tag = 84h 
value = OOh Olh 

Call getLengthO method 
Call copyO method 
Compare the array 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





ETSI 



Release 6 



256 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.4.28 Method appendTLV(byte tag, short valuel , short value2) 

Test Area Reference: Api_2_Pah_Aptlbss. 

5.2.4.28.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV{byte tag, 

short valuel, 
short value2) 
throws ToolkitException 

5.2. 4.28.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (4-byte element(2-short)). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.4.28.1 .2 Parameter errors 
No requirements. 

5.2.4.28. 1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.4.28.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Pah_Aptlbss.java. 
Test Applet: Api_2_Pah_Aptlbss_l.java. 

Cap File: api_2_pah_aptlbss.cap. 



5.2.4.28.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



5.2.4.28.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVQ method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 04 00 01 02 03 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh FDh 
value2 = FCh FBh 








Call copvO method 








Compare the arrays 

compareBuffer = 84 04 00 01 02 03 01 04 
FE FD FC FB 


Result of 

javacard.framework.Utll.arrayCom 
pare{) is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 247 

buffer = 00 81 F4 03 04 ... F6 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F4 03 04 ... F6 84 04 
00 01 02 03 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





5.2.4.29 Method appendTLV(byte tag, byte[] valuel , short valuel Offset, short 
valuel Length, byte[] value2, short value20ffset, short value2Length) 

Test Area Reference: Api_2_Pah_Aptlb_Bss_Bss. 



5.2.4.29.1 



Conformance requirements 



The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte [] valuel, 
short valuelOf f set , 
short valuelLength, 
byte [] value2 , 
short value20f f set , 
short value2Length) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.4.29.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2 byte arrays format). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.4.29.1 .2 Parameter errors 

• CRRPl: If valuel or value2 is null, a NullPointerException is thrown. 

• CRRP2: If valuelOffset or valuelLength or both would cause access outside valuel array bounds, or if 
valuelLength is negative, an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: If value20ffset or value 2Length or both would cause access outside value2 array bounds, or if 
value2Length is negative, an ArraylndexOutOfBoundsException is thrown. 



5.2.4.29.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

CRRC3: If valuelLength or value2Length is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



5.2.4.29.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.4.29.3 



Test area files 

Te s t_ Api_2_Pah_ Aptlb_B ss_Bss.java. 
Api_2_Pah_Aptlb_Bss_Bss_l .Java. 
api_2_pah_aptlb_bss_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


18, 19,20, 21 


N2 


16 


P1 


1,2 


P2 


3, 4, 5, 6, 7 


P3 


8,9, 10, 11, 12 


C1 


13 


C2 


Does not apply for ProactiveHandler 


C3 


14, 15 



5.2.4.29.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


Null valuel 

appendTLV { ) 


NullPointerException is thrown 




2 


Null value2 

appendTLV { ) 


NullPointerException is thrown 




3 


ValuelOffset > valuel. length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 5 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


ValuelOffset <0 

appendTLV { ) 
valuel . length = 5 
valuelOffset = -1 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Valuel Length > valuel .length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 6 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


ValuelOffset + valuelLength > valuel .length 

appendTLV { ) 
Valuel . length = 5 
valuelOffset = 3 
valuelLength = 3 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Valuel Length <0 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = -1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




8 


Value20ffset > value2.length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




9 


Value20ffset < 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




10 


Value2Length > value2.length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




11 


Value20ffset + value2Length > value2.length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
Value2 . length = 5 
Value20ffset = 3 
Value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




12 


Value2Length < 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Handler overflow exception 

Call the appendArray { ) method, length = 

getCapacity { ) - 1 

appendTLV { ) 

Valuel . length = 256 

ValuelOffset = 

ValuelLength = 253 

Value2 . length = 256 

Value20ffset = 

Value2Length = 1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




14 


Bad parameter exception 

Clear the handler 
appendTLV { ) 
Valuel . length = 256 
ValuelOffset = 
ValuelLength = 256 
Value2 . length = 256 
Value20ffset = 
Value2Length = 1 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




15 


Bad parameter exception 

appendTLV { ) 
Valuel . length = 256 
ValuelOffset = 
ValuelLength = 1 
Value2 . length = 256 
Value20ffset = 
Value2Length = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




16 


Successful call does not modify the current 
TLV 

1- clear the handler, append the handler 
with TLVs: 

81 03 11 22 33 

82 02 99 77 

2- Select Command Details TLV by using 
the findTLVO method 

3- Successful call of the AppendTLV {) 
method 

tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Verify Current TLV: Call getValueLength() 
Clear the handler 








Result is 03h 




17 


Successful call 

appendTLV { ) 
tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
ValuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Call copyO method 

Compare handler 

CompareBuffer = 04 10 FF FE ... FO 


Result is 00 




18 


Successful call 

appendTLV { ) 

tag = 85h 

valuel = 00 01 ... 07 

valuelOffset = 2 

ValuelLength = 6 

value2 = 08 09 ... OF 

value20ffset = 2 

value2Length = 6 

Call copyO method 

Compare handler 

CompareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 


Result is 00 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Successful call 

appendTLV { ) 
tag = 01 

valuel = 11 22 ... 88 
valuelOffset = 2 
valuelLength = 4 
value2 = 99 AA ... FF 00 
value20ffset = 2 
value2Length = 4 

Call copyO method 

Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 01 08 33 44 55 

66 BB CC DD EE 

Clear the handler 


Result is 00 




20 


Successful call 

appendTLV { ) 
tag = 04 

valuel = 00 01 ... 7F 
valuelOffset = 
valuelLength = 8 0h 
value2 = 80 81 ... FB 
value20ffset = 
value2Length = 7Ch 

Call copyO method 

Compare handler 

compareBuffer = 04 81 FC 00 01 ...FB 


Result is 00 





5.2.4.30 Method initMoreTime 

Test Area Reference: Api_2_Pah_Inmt. 

5.2.4.30.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initMoreTime { ) 

5.2.4.30.1.1 Normal execution 

• CRRNl: Builds a More Time Proactive command without sending the command. The Comprehension 
Required flags are all set to 1 . 

• CRRN2: After the method invocation no TLV is selected. 



5.2.4.30.1.2 
No requirements. 

5.2.4.30.1.3 
No requirements. 

5.2.4.30.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Pah_Inmt.j ava. 
Api_2_Pah_Inmt_ 1 .j ava. 
api_2_pah_inmt. cap . 
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5.2.4.30.3 



Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



5.2.4.30.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call initMoreTimeO method 

1- Call ProactiveHandler . InitMoreTime { ) . 

2- Call ProactiveHandler . send { ) method. 




1- MORE TIME proactive 
command is fetched. 

TERMINAL RESPONSE of 
MORE TIME is sent to the 
UICC. 


2 


Select a TLV in the ProactiveHandler 
Call the InitMoreTimeO method 

1- Select 1st TLV of the Proactive 
Handler. 

2- Call ProactiveHandler . InitMoreTime {) . 

3- Call ViewHandler .getValueLengthO 
method. 


3- UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthQ method. 





5.2.5 Interface ProactiveResponseHandler 
5.2.5.1 Method copyAdditionallnformation 

Test Area Reference: Api_2_Prh_Cpai. 

5.2.5.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyAdditionallnformation {byte [] dstBuffer, 

short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
ToolkitException 



5.2.5.1.1.1 



Normal execution 



CRRNl: The copyAdditionalInformation() method shall copy a part of the additional information field from 
Result TLV element in dstBuffer, using dstOffset and dstLength. 

CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

CRRN3: The method returns (dstOffset + dstLength). 

CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 

CRRN5: The method shall copy from the first Result TLV. 
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5.2.5.1.1.2 Parameter errors 

• CRRP 1 : A NuUPointerException shall be thrown if dstBuffer is null. 

• CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 



5.2.5.1.1.3 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result 
TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if dstLength is greater than the 
value field of the available TLV. 



5.2.5.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.1.3 



Test area files 

Te s t_ Api_2_Prh_Cp ai .j a va . 
Api_2_Prh_Cpai_l .Java, 
ap i_2_prh_cp ai . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


8, 11, 13, 15, 17,20,22 


N2 


20 


N3 


7, 10, 12, 14, 16,21 


N4 


9, 18,23 


N5 


21, 22,23 


PI 


1 


P2 


2, 3, 4, 5, 6 


C1 


24 


02 


19 



5.2.5.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = 

dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 

Result TLV = 03 OC 01 01 23 45 67 89 AB 
CD EF 01 23 45 








NULL as parameter to dstBuffer 

copyAdditionalInf ormation { ) 
dstBuffer = NULL 


NuUPointerException is tlirown 




2 


dstOffset > dstBuffer.length 

copyAdditionalInf ormation { ) 
dstBuffer.length = 10 
dstOffset = 11 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

copyAdditionalInf ormation { ) 
dstBuffer.length = 10 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

copyAdditionalInf ormation { ) 
dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


dstOffset + dstLength > dstBuffer.length 

copyAdditionalInf ormation { ) 
dstBuffer.length = 10 
dstOffset = 6 
dstLength = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyAdditionalInf ormation { ) 
dstBuffer.length = 10 
dstOffset = 6 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 01 23 45 67 89 








Successful call, dstBuffer is the whole buffer 

copyAdditionalInf ormation { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




8 


Compare dstBuffer using arrayCompare() 
method 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




9 


Call the getValueLengthO method 


Result is 06h. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 

Result TLV = 03 07 01 AB CD EF FE DC BA 








Successful call, dstBuffer is part of a buffer 

copyAdditionalInf ormation { ) 
dstBuffer.length = 7 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




11 


Compare dstBuffer using arrayCompare() 
method 

src = {AB, CD, EF, FE, DC} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7 additional bytes 

Result TLV = 03 08 01 FE DC BA 98 76 54 
32 








Successful call, dstBuffer is part of a buffer 

copyAdditionalInf ormation { ) 
dstBuffer.length = 7 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO Is 
05h. 




13 


Compare dstBuffer using arrayCompare() 
method 

src = {FE, DC, BA, 98, 76} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 8 additional bytes 

Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successful call, dstBuffer is the whole buffer 

copyAdditionalInf ormation { ) 
dstBuffer. length = 9 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




15 


Compare dstBuffer using arrayCompare() 
method 

src = {00, 11, 22, 33, 44} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 

length = 5 


result of arrayCompareO is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 01 00 01 02 03... 








Successful call 

copyAdditionalInf ormation { ) 
dstBuffer. length = F2h 
dstOffset = 
dstLength = F2h 


result of 

copyAdditionallnformationO is 
F2h. 




17 


Compare dstBuffer using arrayCompare() 

src = {00, 01, 02, 03, 04...} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = F2h 


result of arrayCompareO is OOh. 




18 


Call the getValueLengthO method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

copyAdditionalInf ormation { ) 
dstBuffer. length = 6 
dstOffset = 
dstLength = 6 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h...} 








Call the copyAdditionallnformationO method 

dstBuffer. length = 20 
dstOffset = 5 
dstLength = 5 








Compare dstBuffer using arrayCompare() 
method 

src = { 

OOh, Olh, 02h, 03h, 04h, 
OOh, llh, 22h, 33h, 44h, 
OAh, OBh, OCh, ODh, OEh, 
OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length =20 


result of arrayCompareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 
elements 

1st Result TLV = 03 06 01 01 23 45 67 89 
2nd Result TLV = 03 01 00 








Successful call to copyAdditionallnformation() 
method 

dstBuffer. length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




22 


Compare dstBuffer using arrayCompare() 
method 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




23 


Call the getValueLengthO method 


Result is 06h. 




24 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result 
Comprehension TLV 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown by sendQ 






ProactiveResponseHandler, getTheHandler 
call copyAdditionallnformationO 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 





5.2.5.2 Method copyTextString 

Test Area Reference: Api_2_Prh_Cpts. 

5.2.5.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyTextString {byte [] dstBuffer, 

short dstOffset) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.5.2.1.1 



Normal execution 



• CRRNl: The copyTextStringO method copies the text string value from the first Text String TLV element, 
using dstBuffer and dstOffset. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

• CRRN3: The method returns (dstOffset + length of copied value). 

5.2.5.2.1 .2 Parameter errors 

• CRRPl : A NuUPointerException shall be thrown if dstBuffer is null. 

• CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the 
TextString to be copied, without the Data Coding Scheme included), as specified for the returned value, would 
cause access outside array bounds. 
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5.2.5.2.1.3 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 



5.2.5.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.2.3 



Test area files 

Test_Api_2_Prh_Cpts.java. 
Api_2_Prh_Cpts_l .Java. 
api_2_prh_cpts.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6,8, 10, 13, 16, 18,20 


N2 


11, 14,21 


N3 


5,7,9, 12, 15, 17, 19 


P1 


1 


P2 


2,3 


C1 


4 



5.2.5.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








ProactiveResponseHandler.getTheHandlerO ; 

call the copyTextStringO method with a null 
dstBuffer 

dstBuffer = null 
dstOffset = 


NullPointerException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response 

Text String TLV = OD 04 04 "ABC" 








dstOffset + text length > dstBuffer.length 

copyTextString { ) 
dstBuffer.length = 04h 
dstOffset = 02h 


ArraylndexOutOfBoundsException 
is thrown 




3 


dstOffset < 

copyTextString { ) 
dstBuffer.length = 04h 
dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 




Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandlerQ , 

call the CopyTextStringO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with a null Text String tlv 

Text String TLV = OD 








Initialize dstBuffer 

dstBuffer = {FOOh, FOlh, F02h, F03h} 








Call the copyTextStringO method 

dstBuffer. length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 02li 




6 


Compare dstBuffer using arrayCompare() 

src = {OFOh, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = Olh 

Text String TLV = OD 02 04 41 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer. length = 04h 
dstOffset = OOh 


Result of copyTextStringO is 01 li 




8 


Compare dstBuffer using arrayCompare() 

src = {41h, Olh, 02h, 03h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = 02h 

Text String TLV = OD 03 04 42 43 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer. length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 04h 




10 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO Is OOh 




11 


Call the getValueLengthO method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStringO method 

dstBuffer. length = 7Eh 
dstOffset = OOh 


Result of copyTextStringO is 7Eh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare dstBuffer using arrayCompare() 

src = {Olh, ..., 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompareO is OOh 




14 


Call the getValueLengthO method 


Result is 7Fh 




15 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ...7F 








Initialize dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 








Call the copyTextStringO method 

dstBuffer. length = FFh 
dstOffset = lOh 


Result of copyTextStringO is 8Fh 




16 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh,... OFh, 
Olh, ...7Fh, 8Fh, ... FFh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStringO method 

dstBuffer. length = FFh 
dstOffset = OOh 


Result of copyTextStringO is EFh 




18 


Compare dstBuffer using arrayCompare() 

src = {Olh, ...EFh, OOh ... OOh } 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 

1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer. length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 04h 




20 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




21 


Call the getValueLengthO method 


Result is 03h 
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5.2.5.3 Method getAdditionallnformationLength 

Test Area Reference: Api_2_Prh_Glil. 

5.2.5.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getAdditionalInf ormationLength { ) 

throws ToolkitException 



5.2.5.3.1.1 



Normal execution 



• CRRNl : This method returns the length of the additional information field from the first Result TLV in the 
ProactiveResponseHandler. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

5.2.5.3.1.2 Parameter errors 
No requirements. 

5.2.5.3.1.3 Context errors 

• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result 
TLV element. 



5.2.5.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.3.3 



Test area files 

Test_Api_2_Prh_Gtil.java. 

Api_2_Prh_Gtil_l.java. 

api_2_prh_gtil.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1, 3, 5,7,9, 11, 13 


N2 


2,4,6,8, 10, 12, 14 


C1 


15 



5.2.5.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information 








ProactiveResponseHandler.getTheHandlerO ; call 
the getAdditionallnformationLengthO method 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 1 additional byte 

Result TLV = 03 02 02 55 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 01 h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 7Eh additional bytes 

Result TLV = 03 7F 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthQ 

method 


Result is 7Eh 




6 


Call the getValueLengthO method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 7Fh 




8 


Call the getValueLengthO method 


Result is 80h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 80h additional bytes 
Result TLV = 03 81 81 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 80h 




10 


Call the getValueLengthO method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is F2h 




12 


Call the getValueLengthO method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 03 02 01 23 
2nd Result TLV = 03 01 00 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 02h 




14 


Call the getValueLengthO method 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response without Result 
Comprehension TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by sendQ 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLengthQ 
method 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by 
getAdditionallnformationLength () 





5.2.5.4 Method getGeneralResult 

Test Area Reference: Api_2_Prh_Gtgr. 

5.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult { ) 

throws ToolkitException 

5.2.5.4.1.1 Normal execution 

• CRRNl: This method returns the general result of a proactive command. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 



5.2.5.4.1.2 

No requirements. 

5.2.5.4.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result 
TLV element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Comprehension TLV. 



5.2.5.4.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.4.3 



Test area files 

Test_Api_2_Prh_Gtgr.j ava. 
Api_2_Prh_Gtgr_l .Java. 
api_2_prh_gtgr.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 11 


N2 


2,4,6,8, 10, 12 


CI 


13 


C2 


14 
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5.2.5.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 00 
(command performed successfully) 








ProactiveResponseHandler.getTheHandlerQ 
Call the getGeneralResultO method 


Result of getGeneralResultO is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 

without Additional information on result 

(command performed with partial 

comprehension) 








ProactiveResponseHandler.getTheHandlerQ 
Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




4 


Call the getValueLengthO method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 {command 
performed with partial comprehension) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




6 


Call the getValueLengthO method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 {Missing 
information) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResult {) method 


Result of getGeneralResultO is 02h 




8 


Call the getValueLengthO method 


Result is 04h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


Result is 02h 




10 


Call the getValueLengthO method 


Result is 80h 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 








ProactiveResponseHandler.getTheHandlerO , 

call the getGeneralResult { ) method 


Result is 02h 




12 


Call the getValueLengthO method 


Result is 02h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result 
Comprehension TLV 








ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without General Result 
Byte in Result Comprehension TLV 








ProactiveResponseHandler.getTheHandlerQ , 
call the getGeneralResultO method 

Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





5.2.5.5 Method getltem Identifier 

Test Area Reference: Api_2_Prh_Gtii. 

5.2.5.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier { ) 

throws ToolkitException 

5.2.5.5.1.1 Normal execution 

• CRRNl: The method returns the item identifier byte value from the first Item Identifier TLV element. 

• CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 



5.2.5.5.1.2 

No requirements. 

5.2.5.5.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item 
Identifier TLV element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the item identifier byte is 
missing in the Item Identifier Comprehension TLV. 
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5.2.5.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.5.3 



Test area files 

Test_Api_2_Prh_Gtii.java. 
Api_2_Prh_Gtii_l.java. 
api_2_prh_gtii. cap . 

Test coverage 



CRR number 



N1 



N2 



C1 



C2 



Test case number 



2, 4, 6, 8 



3, 5, 7, 9 



10 



5.2.5.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Item Identifier TLV 
available) 








Call to getltemldentifierO with unavailable Item 
Identifier TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEM command with 
2items(ID=01,02) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 








Call the getltemldentifierO method 


Result is 01 h 




3 


Call the getValueByteO method 

valueOffset = OOh 


Result is 01 li 




4 


Build and send a SELECT ITEM command with 
3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getltemldentifierO method 


Result is 05h 




5 


Call the getValueByteO method 

valueOffset = OOh 


Result is 05h 




6 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getltemldentifierO method 


Result is FFh 




7 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




8 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with 2 Item Identifier tlv 

1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getltemldentifierO method 


Result is FFh 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without item identifier in 
the Item Identifier Comprehension TLV 

Item Identifier TLV = 10 00 








Call to getltemldentifierQ 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





5.2.5.6 Method getTextStringCodingScheme 

Test Area Reference: Api_2_Prh_Gtcs. 

5.2.5.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme { ) 

throws ToolkitException 

5.2.5.6.1.1 Normal execution 

• CRRNl: This method returns the data coding scheme from the first Text String TLV element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 



5.2.5.6.1.2 

No requirements. 

5.2.5.6.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the Text String TLV is 
present with a length of 0. 



5.2.5.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.6.3 



Test area files 

Test_Api_2_Prh_Gtcs.java. 
Api_2_Prh_Gtcs_l .Java. 
api_2_prh_gtcs . cap . 

Test coverage 



CRR number 


Test case number 


N1 


3,5,7,9, 11, 13 


N2 


4,6,8, 10, 12, 14 


01 


1 


C2 


2 
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5.2.5.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringCodingSchemeQ with 
unavailable Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 








Call the getTextStringCodingSchemeO method 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringCodingSchemeO method 


Result is 04h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringCodingSchemeO method 


Result is OOh 




6 


Call the getValueLengthO method 


Result is OSh 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringCodingSchemeO method 


Result is OSh 




8 


Call the getValueLengthO method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringCodingSchemeO method 


Result is 04h 




10 


Call the getValueLengthO method 


Result is SOh 




11 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = OSh 

Text String TLV = OD 81 FO 08 01 02 ... EE 
EF 








Call the getTextStringCodingSchemeO method 


Result is OSh 




12 


Call the getValueLengthO method 


Result is FOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringCodingSchemeO method 


Result is 04h 




14 


Call the getValueLengthO method 


Result is 02h 





5.2.5.7 Method GetTextString Length 

Test Area Reference: Api_2_Prh_Gttl. 

5.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTextStringLength { ) 

throws ToolkitException 



5.2.5.7.1.1 



Normal execution 



• CRRNl: The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 



CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 



5.2.5.7.1.2 

No requirements. 

5.2.5.7.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 



5.2.5.7.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.7.3 



Test area files 

Test_Api_2_Prh_Gtd.java. 
Api_2_Prh_Gttl_l.java. 
api_2_prh_gttl. cap . 

Test coverage 



CRR number 


Test case number 


1 


2,4,6, 8, 10, 12, 14 


2 


3,5,7,9, 11, 13, 15 


3 


1 
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5.2.5.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringLengthQ with unavailable 
Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 








Call the getTextStringLengthO method 


Result is OOli 




3 


Call the getValueLengthO method 


Result is OOli 




4 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringLengthO method 


Result is 01li 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 3 "BB" 








Call the getTextStringLengthO method 


Result is 02h 




7 


Call the getValueLengthO method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringLengthO method 


Result is 7Eh 




9 


Call the getValueLengthO method 


Result is 7Fh 




10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringLengthO method 


Result is 7Fh 




11 


Call the getValueLengthO method 


Result is 80h 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = OD 81 FO 04 01 02 ... EE 
EF 








Call the getTextStringLengthO method 


Result is EFh 




13 


Call the getValueLengthO method 


Result is FOli 




14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringLengthO method 


Result is 01li 




15 


Call the getValueLengthO method 


Result is 02h 





5.2.5.8 Method getLength 

Test Area Reference Api_2_Prh_Glen. 

5.2.5.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength {) 

throws ToolkitException 

5.2.5.8.1.1 Normal execution 

• CRRN 1 : returns the length in bytes of the TLV Ust. 

5.2.5.8.1 .2 Parameter errors 
No requirements. 

5.2.5.8.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.5.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.8.3 



Test area files 

Test_Api_2_Prh_Glen.j ava. 
Api_2_Prh_Glen_ 1 .j ava. 
api_2_prh_glen . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for Proactive Response Handler 
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5.2.5.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerQ 

Call getLengthO method 


Result of getLengthO is 12 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerQ 

Call getLengthO method 


Result of getLengthO is FFh 





5.2.5.9 Method copy 

Test Area Reference Api_2_Prh_Copy. 

5.2.5.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy{byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.5.9.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.5.9.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.5.9.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.5.9.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Prh_Copy.j ava. 
Api_2_Prh_Copy_ 1 .j ava. 
api_2_prh_copy .cap. 
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5.2.5.9.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for Proactive Response Handler 



5.2.5.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Additional 
Information in General Result TLV: 

81 03 01 21 00 02 02 82 81 03 01 00 








ProactlveResponseHandler.getTheHandlerO 
copyO with NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copy { ) 

dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




3 


dstOffset < 

copy { ) 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy {) 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy {) 

dstBuffer.length = 13 
dstOffset = 
dstLength = 13 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy {) 

dstBuffer.length = 12 
dstOffset = 
dstLength = 12 


Result of copyO is 12 




9 


Compare the buffer with buffer: 

81 03 01 21 00 02 02 82 81 03 01 00 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy { ) 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyQ is 15 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Compare the whole buffer 

Reference = 
00 01 02 

81 03 01 21 00 

02 02 82 81 

03 01 00 

OF 10 11 12 13 


Result of arrayCompareO is 




12 


Initialize dstBuffer 

dstBuffer = OOh Olh 02h ... 13h 








Successful call, dstBuffer is part of a buffer 

copy {) 

dstBuffer. length = 20 
dstOffset = 3 
dstLength = 9 


Result of copyQ is 12 




13 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

DC OD OE 

OF 10 11 12 13 


Result of arrayCompareO is 





5.2.5.10 Method findTLV 

Test Area Reference Api_2_Prh_Find. 

5.2.5.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV {byte tag, 

byte occurrence) 
throws ToolkitException 

5.2.5.10.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

5.2.5.10.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.5.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



ETSI 



Release 6 



284 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.5.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.10.3 



Test area files 

Test_Api_2_Prh_Find.j ava. 
Api_2_Prh_Find_l .Java. 
api_2_prh_find.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,5, 11, 13 


N2 


2,4 


N3 


10, 12 


N4 


6,7,8,9 


N5 


14,15 


P1 


1 


C1 


Does not apply for Proactive Response Handler 



5.2.5.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

81 03 01 21 00 

82 02 82 81 
03 01 00 

03 02 01 12 








findTLVO with Invalid input parameter 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 


Search 1st TLV 

findTLVO 
tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
tag = 02h 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
tag = 04h 
occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

findTLVO 
tag = Olh 
occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT shall be thrown. 




10 


Search 3rd TLV 

findTLVO 
tag = 03h 
occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLengthO method 


Result is 01 h 




12 


Search 3rd TLV 

findTLVO 
tag = 03h 
occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




13 


Call the getValueLengthO method 


Result is 02h 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


findTLVO 
Tag = 83h 
Occurrence = 


Search tag 83h 

= 1 


Result is 
TLV_FOUND_CR_NOT_SET 




15 


findTLVO 
Tag = 82h 
Occurrence = 


Search tag 82h 

= 1 


Result is TLV_FOUND_CR_SET 





5.2.5.11 Method getValueLength 

Test Area Reference Api_2_Prh_Gvle. 

5.2.5.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength { ) 

throws ToolkitException 



5.2.5.11.1.1 



Normal execution 



CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.5.11.1.2 
No requirements. 

5.2.5.11.1.3 



Parameter errors 



Context errors 



• CRRCl ; if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.11.3 



Test area files 

Test_Api_2_Prh_Gvle.java. 
Api_2_Prh_Gvle_ 1 .j ava. 
api_2_prh_g vie . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


CI 


Does not apply for Proactive Response Handler 


C2 


1 
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5.2.5.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 








ProactiveResponseHandler.getTheHandlerO 

Call getValueLength { ) method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV ODh 








Call getValueLength { ) method 


Result is OOli 




3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








Search TLV ODh (Text String TLV) 








Call getValueLength { ) method 


Result is 02h 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 








Call getValueLength { ) method 


Result is 7Fh 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ... 7E 
7F 








Search TLV ODh (Text String TLV) 








Call getValueLength { ) method 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








Call getValueLength { ) method 


Result is FOh 





5.2.5.12 Method getValueByte 

Test Area Reference Api_2_Prh_Gvby. 

5.2.5.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte {short valueOffset) 
throws ToolkitException 



5.2.5.12.1.1 



Normal execution 



CRRN 1 : Gets a byte from the last TLV element which has been found in the handler and returns its value 

(1 byte). 



5.2.5.12.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 
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5.2.5.12.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.12.3 



Test area files 

Test_Api_2_Prh_Gvby.j ava. 
Api_2_Prh_Gvby_l .Java. 
api_2_prh_gvby . cap . 

Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for Proactive Response Handler 


C2 


1 



5.2.5.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








ProactiveResponseHandler.getTheHandlerQ 








Call getValueByte (0) method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








Call getValueByte (3) method 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








Call getValueByte (2) method 


Result is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








Call getValueByte (0) method 


Result is 82h (Source) 




5 


Search TLV ODh (Text String TLV) 








Call getValueByte {7E) method 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 








Call getValueByte {7E) method 


Result is 7Eh 




7 


Call getValueByte {7F) method 


Result is 7Fh 




8 


Call getValueByte (EF) method 


Result is EFh 
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5.2.5.13 Method copyValue 

Test Area Reference Api_2_Prh_Cpyvs_Bss. 

5.2.5.13.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue {short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.5.13.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.5.13.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.5.13.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.13.3 



Test area files 

Test_Api_2_Prh_Cpyv.j ava. 
Api_2_Prh_Cpy v_ Lj ava. 
api_2_prh_cpy V. cap . 

Test coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


CI 


Does not apply for Proactive Response Handler 


C2 


11 
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5.2.5.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 

Select Text String TLV 








call copyValueO method 
with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 

dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




7 


valueOffset > Text String Length 

copyValue { ) 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

copyValue { ) 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

copyValue { ) 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


ValueOffset + dstLength > Text String length 

copyValue { ) 
ValueOffset = 2 
DstBuffer.length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandler 








call copyValueO method 


ToolkltException.UNAVAILABLE 
ELEMENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Select Text String TLV 








Successful call 

copyValue { ) 
ValueOffset = 
DstBuffer. length = 17 
DstOffset = 
DstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue { ) 
ValueOffset = 2 
DstBuffer. length = 20 
DstOffset = 3 
DstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





5.2.5.14 Method compareValue 

Test Area Reference Api_2_Prh_Cprv. 

5.2.5.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue {short ValueOffset, 

byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws Java. lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.5.14.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.5.14.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 
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5.2.5.14.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.5.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.14.3 



Test area files 

Test_Api_2_Prh_Cprv.j ava. 
Api_2_Prh_Cprv_ 1 .j ava. 
api_2_prh_cprv . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17 


PI 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for Proactive Response Handler 


C2 


11 



5.2.5.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactlveResponseHandler.getTheHandlerQ 

Select Text String TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


valueOffset > Text String Length 

compareValue { ) 
valueOffset = 7 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

compareValue { ) 
valueOffset = -1 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

compareValue { ) 
valueOffset = 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

compareValue { ) 
valueOffset = 2 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








call compareValueQmethod 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Select Text String TLV 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue { ) 
ValueOffset = 
CompareOf f set = 
CompareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

compareValue { ) 
ValueOffset = 2 
CompareOf f set = 3 
CompareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





5.2.5.1 5 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference Api_2_Prh_Facyb_Bs. 

5.2.5.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue {byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.5.15.1.1 



Normal execution 



• CRRNl : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.5.15.1.2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.5.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.5.15.2 Test area files 

Test Source: Test_Api_2_Prh_Facyb_Bs.java. 
Test Applet: Api_2_Prh_Facyb_Bs_Ljava. 

Cap File: api_2_prh_facyb_bs.cap. 
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5.2.5.15.3 



Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Response Handler 



5.2.5.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactlveResponseHandler.getTheHandlerQ 








call fIndAndCopyValueO method with a null 
dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

f indAndCopyValue { ) 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length =20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactlveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 








fIndAndCopyValueO 

tag = 04h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Successful call 

f IndAndCopyValue { ) 
Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f indAndCopyValue { ) 
DstBuffer.length = 20 
DstOffset = 2 


Result of findAndcopyValueO is 
19 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
OD 02 04 41 








ProactiveResponseHandler.getTheHandlerQ 








Successful call 

f indAndCopyValue { ) 
Tag = ODh 

DstBuffer. length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




13 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Successful call (with tag 8Dh) 

f IndAndCopyValue { ) 
Tag = 8Dh 

DstBuffer. length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





5.2.5.1 6 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference Api_2_Prh_Facybbs_Bss. 



5.2.5.16.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.5.16.1.1 



Normal execution 



• CRRN 1 : looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 
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5.2.5.16.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.5.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.5.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.16.3 



Test area files 

Te s t_ Api_2_Prh_Facybb s_B s s .j a va . 
Api_2_Prh_Facybbs_Bss_l .Java. 
api_2_prh_facybbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


22 


CI 


Does not apply for Proactive Response Handler 



5.2.5.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 6 

dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


dstLength > dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


dstLength < 

f IndAndCopyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD OS 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 








valueOffset > Text String Length 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 7 

dstBuffer.length = 15 

dstOffset = 

dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue { ) 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

f indAndCopyValue { ) 

Tag = ODh, occurrence = 1 

ValueOffset = 

DstBuffer.length = 17 

DstOffset = 

DstLength = 17 


Result of findAndCopyValueO is 
17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 

Tag = ODh, occurrence = 1 

ValueOffset = 2 

DstBuffer. length = 20 

DstOffset = 3 

DstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 02 ... OF 

OD 06 00 11 22 33 44 55 {no specific DCS 

byte) 








ProactiveResponseHandler.getTheHandlerQ 








Successful call 

f IndAndCopyValue { ) 

Tag = ODh, occurrence = 1 

ValueOffset = 

DstBuffer. length = 17 

DstOffset = 

DstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

f IndAndCopyValue { ) 

Tag = ODh, occurrence = 2 

ValueOffset = 

DstBuffer. length = 6 

DstOffset = 

DstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Successful call (with tag 8Dh) 

f IndAndCopyValue { ) 

Tag = 8Dh, occurrence = 1 

ValueOffset = 

DstBuffer. length = 17 

DstOffset = 

DstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




22 


Invalid parameter 

f IndAndCopyValue { ) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 
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5.2.5.17 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference Api_2_Prh_Facrb_Bs. 

5.2.5.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte [] compareBuffer, 
short compareOffset) 
throws Java . lang.NullPointerException, 

Java. lang.ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.5.17.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -L 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.5.17.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 

5.2.5.17.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.5.17.2 Test area files 

Test Source: Test_Api_2_Prh_Facrb_Bs.java. 
Test Applet: Api_2_Prh_Facrb_Bs_Ljava. 

Cap File: api_2_prh_facrb_bs.cap. 
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5.2.5.17.3 



Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Response Handler 



5.2.5.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








FindAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = ODh 

compareBuffer.length =20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f IndAndCompareValue { ) 
compareBuffer.length =20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + length > 
compareBuffer.length 

f IndAndCompareValue { ) 
CompareBuffer.length =20 
CompareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = 04h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize compareBuffer 

CompareBuf f er = 
04 00 01 ... OF 








Compare buffers 

f IndAndCompareValue { ) 
Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

Call getValueLengthO method 


Result is 17 




9 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f indAndCompareValue { ) 
CompareOf f set = 2 


Result is OOh 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandierQ 








Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue { ) 
CompareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f indAndCompareValue { ) 
CompareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

f IndAndCompareValue { ) 
CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

f indAndCompareValue { ) 
Tag = 8Dh 
CompareOf f set = 


Result is OOh 





5.2.5.18 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference Api_2_Prh_Facrbbs_Bss. 
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5.2.5.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.5.18.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.5.18.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException 
shall be thrown. The reason code shall be ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 

5.2.5.1 8.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.5.18.2 Test area files 

Test Source: Test_Api_2_Prh_Facrbbs_Bss.java. 
Test Applet: Api_2_Prh_Facrbbs_Bss_l.java. 

Cap File: api_2_prh_facrbbs_bss.cap. 
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5.2.5.18.3 



Test coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17, 20,21 


N4 


15, 18,22 


N5 


16, 19 


N6 


23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


C1 


Does not apply for Proactive Response Handler 



5.2.5.18.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 
ProactiveResponseHandler . getTheHandler { ) 








flndAndCompareValueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

f IndAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + compareLength 
>compareBuffer.length 

f indAndCompareValue { ) 
CompareBuffer.length = 5 
CompareOffset = 3 
CompareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 








valueOffset > Text String Length 

f indAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


valueOffset < 

f IndAndCompareValue { ) 
valueOffset = -1 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue { ) 
valueOffset = 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue { ) 
valueOffset = 2 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue { ) 
Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown. 




13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

Call getValueLengthO method 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandier.getTheHandlerQ 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag SDh) 

f IndAndCompareValue { ) 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 





5.2.5.19 Method getCapacity 

Test Area Reference: Api_2_Prh_Gcap. 

5.2.5.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity { ) 

5.2.5.19.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 
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5.2.5.20.1.2 
No requirements. 

5.2.5.20.1.3 
No requirements. 

5.2.5.19.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.19.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Prh_Gcap.j ava. 
Api_2_Prh_Gcap_l .Java. 
api_2_prh_gcap.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 



5.2.5.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


ProactiveResponseHandler available 

1- Send envelope Menu Selection 

2- The applet sends a proactive command 

3- Fetch the proactive command and send 
Terminal Response 

4- The applet calls getCapacity { ) method 

5- The applet calls getLength { ) method 


1 - Applet is triggered 

4-No exception is thrown 

5- The Capacity result is greater or 

equal to getLengthQ result 


2- 91 XX 

3- The proactive command 
is fetched 



5.2.5.20 Method getChannelldentifier 

Test Area Reference: Api_2_Prh_Gcid. 

5.2.5.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getChannelldentif ier { ) 

throws ToolkitException 

5.2.5.201.1.1 Normal execution 

• CRRNl:The method shall return the channel identifier byte value. 

• CRRN2:The channel identifier byte value returned shall be from the first Channel status TLV element. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

5.2.5.20.1 .2 Parameter errors 
No requirements. 

5.2.5.20.1 .3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if the Channel status TLV 
is not present. 
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CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if the Comprehension 
TLV Channel Status length is equal to 0. 



5.2.5.20.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.21.3 



Test area files 

Test_Api_2_Prh_Gcid.j ava. 
Api_2_Prh_Gcid_l .Java. 
api_2_prh_gcid. cap . 

Test coverage 



CRR number 


Test case number 


N1 


3 


N2 


4 


N3 


5 


C1 


1 


C2 


2 
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5.2.5.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Appletl is installed with maximum number 
of channel = 01. 






1 


Channel status TLV is not present 

1- Build and send a DISPLAY TEXT command 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ier{) method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- DISPLAY TEXT 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with no Channel status TLV 
available. 


2 


Channel status TLV with a length equal to 

1- Build and send a OPEN CHANNEL proactive 
command 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ier{) method. 


2- OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with Channel status TLV 
length equal to 0. 


3 


Get channel identifier value 

1- Call ProactiveHandler . init { ) method to 
open a channel and ProactiveHandler . send { ) 
method . . 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ier{) method. 

3- Call 

ProactiveHandler . initCloseChannel { ) and 
ProactiveHandler . send { ) methods. 


2- Returns 0x01 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x81 00. 


4 


Get channel identifier value with 2 TLV 

1- Call ProactiveHandler . init { ) method to 
open a channel and ProactiveHandler . send { ) 
method 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ier{) 

3- Call 

ProactiveHandler . initCloseChannel { ) and 
ProactiveHandler . send { ) methods. 


2- Returns 0x01 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100 and 0x8200. 


5 


Channel status TLV is currently selected TLV 

1- Call ProactiveHandler . init { ) method to 
open a channel and ProactiveHandler . send { ) 
method . 

Call ViewHandler.FindTLVO method with 
Device Identity Tag. 

2- Call 

ProactiveResponseHandler . getChannelldentif 
ierO method. 

3 - Compare 

ProactiveResponseHandler . getChannelldentif 
ier{) and ViewHandler .getValueByte (0) 
method results. 


2- Returns 0x03 

3- Check getChannelldentifier() 
=getValueByte{0) 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x0305v 
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5.2.5.21 Method copyChannelData 

Test Area Reference: Api_2_Prh_Cchd. 

5.2.5.21.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short copyChannelData {byte [] dstBuffer, 

short dstOffset, 
short dstLength) 
throws Java. lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.5.21 .1 .1 Normal execution 

• CRRNl : The method shall copy a part of the Channel data string field. 

• CRRN2: The Channel data string field value returned shall be the first Channel data TLV element of the 
current response data field. 

• CRRN3: If the element is available it becomes the currenly selected TLV. 

• CRRN4: Returns dstOffset + dstLength. 

5.2.5.21.1.2 Parameter errors 

• CRRPl: If dstBuffer is null, a NuUPointerException is thrown. 

• CRRP2: If dstOffset or dstLength parameter is negative an ArraylndexOutOfBoundsException exception is 
thrown and no copy is performed. 

• CRRP3: If dstOffset+dstLength is greater than dstBuffer. length, the length of the dstBuffer array an 
ArraylndexOutOfBoundsException exception is thrown and no copy is performed. 

• CRRP4: If dstLength is greater than the value field of the available TLV, a OUT_OF_TLV_BOUND ARIES 
ToolkitException is thrown. 

5.2.5.21.1.3 Context errors 

• CRRC 1 : The method shall throw a UN AV AILABLE_ELEMENT ToolkitException if the Result TLV is not 
present. 

5.2.5.21.2 Test area files 

Test Source: Test_Api_2_Prh_Cchd.java. 
Test Applet: Api_2_Prh_Cchd_l.java. 

Cap File: api_2_prh_cchd.cap. 
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5.2.5.21.3 



Test coverage 



CRR number 


Test case number 


N1 


7, 10, 12, 14 


N2 


14 


N3 


9 


N4 


8, 11, 13, 15 


P1 


1 


P2 


2,3 


P3 


4 


P4 


5 


C1 


6 



5.2.5.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





1- Appletl is installed with maximum 
number of channel = 01. 

2- Appletl builds proactive commands OPEN 
CHANNEL with init { ) method in order to 
open one channel. 

ProactiveHandler . send { ) method is called. 




2- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 


1 


CopyChannelDataO with NULL dstBuffer 

Build and send a RECEIVE DATA command 

Call 

ProactiveResponseHandler . copyChannelData { ) 

dstBuffer = NULL 

DstOffset = 

DstLength = 1 


NullPointerException is thrown 


RECEIVE DATA Proactive 
command is fetched. 

TERMINAL RESPONSE 
with not empty Channel 
Data TLV is issued. 


2 


CopyChannelDataO with negative dstOffset 

1- call initO method for the RECEIVE DATA 
proactive command. 

2- call 

ProactiveResponseHandler . copyChannelData { ) 
DstBuffer. length = 6 

DstOffset = -1 
DstLength = 1 

3- check dstBuffer is empty. 


2- an 

ArraylndexOutOfBoundsException 
exception is thrown. 

3- no copy is performed. 


1- RECEIVE DATA 
proactive command is 
fetched. 

TERMINAL RESPONSE 
with 6 bytes avalaible 
('Hellol') 


3 


CopyChannelDataO with negative dstLength 

1- call 

ProactiveResponseHandler. copyChannelData { ) 
DstBuffer. length = 6 

DstOffset = 
DstLength = -1 

2- check dstBuffer is empty. 


1- an 

ArraylndexOutOfBoundsException 
exception is thrown. 

2- no copy is performed. 




4 


CopyChannelDataO with dstOffset+dstLength 
greater than dstBuffer.length 

1- call 

ProactiveResponseHandler . copyChannelData { ) 
with dstOffset+dstLength greater than 
dstBuffer . length . 

DstBuffer.length = 6 
DstOffset = 5 
DstLength = 2 

2- check dstBuffer is empty. 


1- an 

ArraylndexOutOfBoundsException 
exception is thrown. 

2- no copy is performed. 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


CopyChannelDataO with dstLength too large 

Call 

ProactiveResponseHandler . copyChannelData { ) 

with dstLength greater than the value 

field of the available TLV. 

DstBuffer. length = 10 

DstOffset = 

DstLength = 10 


an OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown. 




6 


CopyChannelDataO without Channel Data TLV 
element 

1- call initO method for the RECEIVE DATA 
proactive command. 

Call send{) method. 

2- call 

ProactiveResponseHandler. copyChannelData {) 
DstBuffer. length = 10 

DstOffset = 
DstLength = 10 


2- an UNAVAILABLE_ELEMENT 
ToolkitException is thrown. 


1- RECEIVE DATA 
proactive command is 
fetched 

TERMINAL RESPONSE 
without ChannelData TLV 
element. 


7 


Successful CopyChannelDataO 

Call initO method for the RECEIVE DATA 
proactive command. 
Call send{) method. 

2- Call findTLVO with TAG of DEVICE 
IDENTITY. 

3- Call 

ProactiveResponseHandler . copyChannelData { ) 
DstBuffer. length = 6 

DstOffset = 
DstLength = 6 
DstBuffer is the whole Buffer. 


3- the Channel Data TLV is copied 
into dstBuffer. 

The applet checks the returned 
value is dstOffset + dstLength = 6. 


1- RECEIVE DATA 
proactive command is 
fetched 

TERMINAL RESPONSE 
with one Channel data TLV 
element. (6 bytes available 
= 'Hello2') 


8 


Compare copied Buffer 

Check dstBuffer. 


The applet checks that dstBuffer 
contains the channel data from the 
TERMINAL RESPONSE. 




9 


Check the Channel Data TLV is selected 

Call the ViewHandler.getValueByte{0) 
method 


The returned byte is the same than 
the first byte of the Channel data 
TLV (i.e. 'H') 




10 


Successful CopyChannelDataO 

Call 

ProactiveResponseHandler . copyChannelData { ) 

DstBuffer. length = 6 

DstOffset = 2 

DstLength = 3 

DstBuffer is a part of Buffer. 


The Channel Data TLV is copied 
into dstBuffer. 

The applet checks the returned 
value is dstOffset + dstLength = 5. 




11 


Compare copied Buffer 

Check dstBuffer. 


The applet checks that bytes from 2 
to 4 of dstBuffer contain the first 3 
bytes of channel data TLV from the 
TERMINAL RESPONSE. 




12 


Successful CopyChannelDataO 

1- Initialize dstBuffer to [00, 01...] 

2- Call 

ProactiveResponseHandler . copyChannelData { ) 
DstBuffer. length = 6 

DstOffset = 2 
DstLength = 3 

DstBuffer is a part of buffer. 


2- The Channel Data TLV is copied 
into dstBuffer. 

The returned value is dstOffset + 
dstLength = 5. 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare copied Buffer 

Check dstBuffer. 


The applet checks that only bytes 
from 2 to 4 of dstBuffer have been 
updated with the first 3 bytes of 
channel data TLV from the 
TERMINAL RESPONSE. 




14 


Successful copyChiannelDataO, with 2 TLV 

1- call initO method for the RECEIVE DATA 
proactive command. 

Call send{) method. 

2- call 

ProactiveResponseHandler . copyChannelData { ) 
with dstLength lower than the value field 
of the available TLV. 

DstBuffer. length = 6 
DstOffset = 
DstLength = 6 


2- the first Channel Data TLV is 
copied into dstBuffer. 
The returned value is 
dstOffset+dstLength =0x06 


1- RECEIVE DATA 
proactive command is 
fetched 

TERMINAL RESPONSE 

with two Channel data TLV 

element 

1"' TLV: 6 bytes available = 

'Hello3' 

2""^ TLV : 6 bytes available = 

'Hello4' 


15 


Compare copied Buffer 

Check dstBuffer. 


Check that dstBuffer contains the 
first Channel Data TLV from the 
TERMINAL RESPONSE. 





5.2.5.22 Method getValueShort 

Test Area Reference: Api_2_Prh_Gvsh. 

5.2.5.22.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort {short valueOffset) 
throws ToolkitException 



5.2.5.22.1.1 



Normal execution 



CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.5.22.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.5.22.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.5.22.2 Test area files 

Specific triggering: None. 

Test Source: Test_Api_2_Prh_Gvsh.java. 
Test Applet: Api_2_Prh_Gvsh_l.java. 

Cap File: api_2_prh_gvsh.cap. 
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5.2.5.22.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for Proactive Response Handler 


C2 


1 



5.2.5.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 

Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 

ProactiveResponseHandler.getTheHandlerO 

Call getValueShort (0) method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 


GET INPUT Proactive 
command 


2 


Search TLV Olh {Command Details TLV) 
Call getValueShort (3) method 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV Olh {Command Details TLV) 
Call getValueShort (1) method 


Result is 23h OOh (Type, qualifier) 




4 


Search TLV 02h {Device Identities TLV) 
Call getValueShort {0) method 


Result is 82h 81 h (Source, 
destination) 




5 


Search TLV ODh {Text String TLV) 
Call getValueShort {7D) method 


Result is 7Dh 7Eh 




6 


Send a GET INPUT command 

Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 

Search TLV ODh (Text String TLV) 

Call getValueShort {7D) method 


Result is 7Dh 7Eh 


GET INPUT Proactive 
command 


7 


Call getValueShort {7F) method 


Result is 7Fh 80h 




8 


Call getValueShort {EE) method 


Result is EEh EFh 





5.2.5.23 Method getChannelStatus 

Test Area Reference: Api_2_Prh_Gcst. 

5.2.5.23.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getChannelStatus {byte channelldentif ier) 

throws ToolkitException 

5.2.5.23.1.1 Normal execution 

• CRRNl : The method shall return the value of the first Channel Status TLV element. 

• CRRN2: The Channel Status value returned shall be from the element whose channel identifier is equal to the 
Channelldentifier parameter. 

• CRRN3: If the element is available it becomes the currently selected TLV. 

5.2.5.23.1.2 Parameter errors 
No requirements. 
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5.2.5.23.1.3 



Context errors 



CRRCl: The method shall throw ToolkitException.UNAVAILABLE_ELEMENT if no Channel Status TLV 
element with the right identifier could be found. 

CRRC2: The method shall throw ToolkitException.OUT_OF_TLV_BOUND ARIES if a Channel Status TLV 
element with the right identifier could be found but its value is less than 2 bytes long. 



5.2.5.23.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.5.23.3 



Test area files 

Test_ Api_2_Prh_Gcst.java. 
Api_2_Prh_Gcst_l .Java. 
api_2_prh_gcst.cap. 

Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


5,7 


N3 


8 


C1 


1,2,3 


C2 


4 
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5.2.5.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Appletl is installed with maximum number 
of channel = 01. 






1 


Channel status TLV is not present 

1- Build and send a DISPLAY TEXT command 

2- Call ProactiveResponseHandler . 
getChannelStatus (0x01) method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- DISPLAY TEXT Proactive 
command is fetched. 

TERIVIINAL RESPONSE 
with no Channel status TLV 
available. 


2 


Channel status TLV with the identifier is not 
present 

1- Build and send a OPEN CHANNEL 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus { 0x02 ) method . 

3- Call 

ProactiveHandler . initCloseChannel (0x01) 
and ProactiveHandler . send { ) methods. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100. 

3- Succesfull terminal 
response to 

InitCloseChannel proactive 
command. 


3 


Channel status TLV with a length equal to 

1- Build and send a OPEN CHANNEL 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 


2- UNAVAILABLE_ELEMENT 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with Channel status TLV 
length equal to 0. 


4 


Channel status TLV with a length equal to 1 

1- Build and send a OPEN CHANNEL 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 


2- OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 


1- OPEN CHANNEL 
Proactive command is 
fetched. 

TERMINAL RESPONSE 
with Channel status TLV 
length equal to 1. 


5 


Get channel status value 

1- Call ProactiveHandler . init { ) method to 
open a channel and 
ProactiveHandler . send { ) method. 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 

3- Build and send a get channel status 
proactive command. 


2- Returns 0x8100 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x8100. 


6 


Get channel status value with 2 TLV 

1- Build and send a get channel status 
proactive command 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x01) method. 


2- Returns 0x8100 


1- Get channel status 
proactive command is 
fetched. 

TERMINAL RESPONSE is 
issued with 2 channel status 
value = 0x81 00 and 0x81 01. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Get channel status value with 2 TLV 

1- Build and send a Get Channel status 
proactive command. 

2- Call ProactiveResponseHandler . 
getChannelStatus (0x01) method. 

4- Call 

ProactiveHandler . initCloseChannel { ) and 

ProactiveHandler . send { ) methods. 


2- Returns 0x81 00 


1- Get channel status 
proactive command is 
fetched. 

TERMINAL RESPONSE is 
issued with 2 channel status 
value = 0x8200 and 0x8100. 

3- Succesfull terminal 
response to 

InitCloseChannel proactive 
command. 


8 


Channel status TLV is currently selected TLV 

1- Call ProactiveHandler . init { ) method to 
open a channel and 
ProactiveHandler . send { ) method. 

Call ViewHandler.FindTLVO method with 
Device Identity Tag. 

2- Call ProactiveResponseHandler. 
getChannelStatus (0x03) method. 

3- Compare ProactiveResponseHandler. 
getChannelStatus { ) and 
ViewHandler . getValueShort { ) method 
results . 

4- Call 

ProactiveHandler. initCloseChannel (0x03) 
and ProactiveHandler . send { ) methods. 


2- Returns 0x0304 

3- Check getChannelStatusQ 
=getValueShort(G) 


1- OPEN CHANNEL 
Proactive Command is 
fetched. 

TERMINAL RESPONSE is 
issued with channel status 
value = 0x0304. 

3- Succesfull terminal 
response to 

InitCloseChannel proactive 
command. 



5.2.6 Interface ToolkitConstants 
5.2.6.1 Constants 

Test Area Reference: Api_2_Tkc_Cons. 

5.2.6.1.1 Conformance requirement 

There is no API, only constants. This constants shall be compare to its definition in the API. 

5.2.6.1.1.1 Normal execution 

• CRRNl: The Toolkit Constants shall all have the same name and value as defined in TS 102 241 [9]. 



5.2.6.1.1.2 

No requirements. 

5.2.6.1.1.3 

No requirements. 

5.2.6.1.2 

None. 



Parameter errors 



Context errors 



Test area files 
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5.2.6.1.3 



Test procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

5.2.7 Interface Too I kit Interface 
5.2.7.1 Method processToolkit 

Test Area Reference: Api_2_Tki_Prtk. 

5.2.7.1.1 Conformance requirement: 

The method with following prototype shall be compliant to its definition in the API. 

public void processToolkit {short event) 

throws ToolkitException 



5.2.7.1.1.1 



Normal execution 



• CRRNl: This interface shall be implemented by a Toolkit applet (which extends the 
javacard.framework.Applet class) so that it can be triggered by the Toolkit Triggering Entity according to the 
registration information. 

• CRRN2: The Toolkit applet will have to implement the processToolkit shared method. 

5.2.7.1.1.2 Parameter errors 
No requirements. 

5.2.7.1.1.3 Context errors 
No requirements. 

5.2.7.1.2 Test area files 

The method is tested in the CAT Runtime Environment. 



5.2.7.1.3 



Test coverage 



CRR number 


Test case number 


N1 


Tested in the whole test suite 


N2 


Tested in the whole test suite 



5.2.8 Interface ToolkitRegistry 
5.2.8.1 Method allocateTimer 

Test Area Reference: Api_2_Tkr_Atim. 

5.2.8.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer { ) 

throws ToolkitException 
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5.2.8.1 .1 .1 Normal execution 

CRRNl: the returned timer identifier shall be between 01 and 08 inclusive. 

CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 

CRRN3: By calling this method the applet is registered to the EVENT_TIMER_EXPIRATION of the 
allocated timer. 

CRRN4: The timer is allocated by the applet until it explicitly releases it. 

CRRN5: When a timer is allocated, the applet can issue the Timer Management proactive command to start, 
stop or get the value of its allocated timer. 



5.2.8.1.1.2 

No requirements. 

5.2.8.1.1.3 



Parameter errors 



Context errors 



• CRRC 1 : Shall throw a ToolkitException with reason NO_TIMER_ AVAILABLE if all the timers are 
allocated. 

• CRRC2: Shall throw a ToolkitException with reason NO_TIMER_ AVAILABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

5.2.8.1.2 Test area files 

Test Source: Test_Api_2_Tkr_Atim.java. 
Test Applet: Api_2_Tkr_Atim_l.java. 

Api_2_Tkr_Atim_2.j ava. 

Api_2_Tkr_Atim_3 .j ava. 
Cap File: api_2_tkr_atim.cap. 

Installation parameters: 

• The maximum number of timers is as follows for each applet: 

Applet 1 (Api_2_Tkr_Atim_l): 8 timers. 
Apple t2 (Api_2_Tkr_Atim_2): 4 timers. 
Applets (Api_2_Tkr_Atim_3): timer. 



5.2.8.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,4 


N2 


1,4 


N3 


3 


N4 


3,4 


N5 


Cat Runtime Environment, 
Cre Pes Pceo 


CI 


2 


C2 


5 
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5.2.8.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(Appletl) 

Call 8 times allocateTimer { ) and 
isEventSet {TIMER EXPIRATION) . 


No exception shall be thrown. 
Timer ID returned shall be between 
01 and 08 inclusive. It shall be 
different after each call. 
Shall return true. 




2 


Allocate timers more than the maximum 
(Appletl) 

The Appletl allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 

ENVELOPE(TIMER_EXPIRATION) command 

(appletl) 

Send ENVELOPE {TIMER EXPIRATION) with all 
timers id {not in an increase order) . 

Call releaseTimer {id) each time a timer 
expires . 

Call isEventSet {EVENT_TIMER_EXPIRATION) 
method 


Shall trigger each time an 
ENVELOPE(TIMER EXPIRATION) 
is sent to the UICC, for Timer ID = 
'01 'to '08'. 
Returns false. 




4 


Allocate up to 4 timers 
(Applet2) 

Call 4 times allocateTimer { ) . 


No exception shall be thrown. Each 
time, the returned timer identifier 
shall be between '01' and '08' 
inclusive. It shall be different after 
each call. 




5 


Allocate timers more than the maximum 
(Applet3) 

The Applets allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





5.2.8.2 Method changeMenuEntry 

Test Area Reference: Api_2_Tkr_Cmet. 



5.2.8.2.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

public void changeMenuEntry {byte id, 

byte [] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier, 
short iconldentif ier) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
ToolkitException 



5.2.8.2.1.1 



Normal execution 



CRRNl: After the invocation of this method, during the current card session, the CAT Runtime Environment 
shall dynamically update the menu stored in the Terminal. The CAT Runtime Environment shall use the data 
of the EFgujyfg file under the DF_Telecom when issuing the SET UP MENU proactive command. 

CRRN2: The default state of the changed menu entry is 'enabled'. 

CRRN3: a call to isEventSet() method on EVENT_MENU_S ELECTION shall return true before and after the 
call. 
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• CRRN4: if changeMenuEntryO method is called with helpSupported set to true then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

• CRRN5: if changeMenuEntryO method is called with helpSupported set to true andif an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the UICC for this entry, then 
after the completion of the SET UP MENU command, the CAT Runtime Environment shall trigger the applet. 

• CRRN6: if changeMenuEntryO method is called with helpsupported set to true, the CAT Runtime 
Environment shall issue a SET UP MENU command with command qualifier = '80'. 

• CRRN7: if changeMenuEntryO method is called with helpSupported set to false and if no entry is supporting 
help then a call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST event shall 
return false. 

• CRRN8: if changeMenuEntryO method is called with helpSupported set to false, if no entry is supporting help 
and if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the UICC, then 
after the completion of the SET UP MENU command, the CAT Runtime Environment shall not trigger the 
applet. 

• CRRN9: The CAT Runtime Environment shall supply in the SET UP MENU command, the icon identifier 
provided in the icon identifier list within the item icon identifier list Comprehension TLV if all the applets 
registered to the EVENT_MENU_SELECTION provide it. 

• CRRNIO: The CAT Runtime Environment shall set in the SET UP MENU command, the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory', if one of the applet registered prefers this qualifier. 

• CRRN 1 1 : If Next Action Indicator is different from '00', the CAT Runtime Environment shall issue a SET UP 
MENU proactive command containing an Item Next Action Indicator Comprehension TLV with the 
comprehension flag set to as defined in TS 102 223 [6]. 

5.2.8.2.1 .2 Parameter errors 

• CRRPl: A java.lang.NullPointerException is thrown if menuEntry is null. 

• CRRP2: A java.lang.ArraylndexOutOfBoundsException is thrown if offset would cause access outside array 
bounds. 

• CRRP3: A java.lang.ArraylndexOutOfBoundsException is thrown if length would cause access outside array 
bounds. 

• CRRP4: A java.lang.ArraylndexOutOfBoundsException is thrown if both offset and length would cause 
access outside array bounds. 

5.2.8.2.1.3 Context errors 

• CRRCl : A ToolkitException with MENU_ENTRY_NOT_FOUND reason is thrown if the Menu Identifier 
isn't associated to the calling applet instance. 

• CRRC2: A ToolkitException with ALLOWED_LENGTH_EXCEEDED reason is thrown if the menu entry 
string is bigger than the allocated space. 

5.2.8.2.2 Test area files 

Additional requirements for the UICC personalization: 

• content of EF sume shall be: 

Tide Alpha Identifier: "TOOLKIT TEST" . 
Test Source: Test_Api_2_Tkr_Cmet.java. 

Test Applet: Api_2_Tkr_Cmet_Ljava. 

entry'01'is"Initl". 
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entry'02'is"Init2". 
Installation parameter: 

• Same as default applet but with: 

Maximum text length for a menu entry: 
Maximum number of menu entries: 
Position / Identifier for each menu entry: 

Cap File: api_2_tkr_cmet.cap. 



15. 

2. 

'017'01','027'02'. 



5.2.8.2.3 



Test coverage 



5.2.8.2.4 



CRR number 


Test case number 


N1 


1,2,3,4,6,8,9,20 


N2 


9 


N3 


1,2,3,4,6,8,9,20 


N4 


6 


N5 


7,5 


N6 


6 


N7 


1,2,3,4,8,9,20 


N8 


Tested in CAT Runtime Environment: 
Cre Apt Emsh (Test case 1 ) 


N9 


8,9 


N10 


8 


N11 


4 


P1 


10 


P2 


11, 12, 13 


P3 


14, 15 


P4 


16 


C1 


17, 18 


C2 


19 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet changes the entry's title by menuEntry 

buffer, with a greater length than the Initial 

length 

1- Call changeMenuEntry { ) with 
parameters : 

Id = '02' 

MenuEntry = "UseAllBuf f er" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = . 

2- Call isEventSet {EVENT_MENU_SELECTION) . 

3- Call 

isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 
ST) . 


1 - No exception sliall be thrown. 

2- shall return true. 

3- shall return false. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Changing the title with part of menuEntry 
buffer 

1- Call ChangeMenuEntry { ) with 
parameters : 








Id = '01' 


1 - No exception shall be thrown. 






MenuEntry = "UsePartOfBuf f er" 








Offset = 3 


2- Shall return true. 






Length = 12 








NextAction = 
HelpSupported = false 


3- Shall return false. 






IconQualif ier = 








Iconldentif ier = . 








2- Call isEventSet {EVENT_MENU_SELECTION) . 




The UICC shall issue a 




3- Call 




SETUP MENU proactive 




isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 




command which contains 




ST) 




the new text for entry ID 
'01'. 


3 


Length = 

1- Call ChangeMenuEntry {) for entry '01' 
and entry '02', with parameters: 

Id = '01'/' 02' 








MenuEntry = "LengthEqualsO" 
Offset = 


1 - No exception shall be thrown. 






Length = 








NextAction = 


2- Shall return true. 






HelpSupported = false 








IconQualif ier = 


3- shall return false. 






Iconldentif ier = . 








2- Call isEventSet {EVENT_MENU_SELECTION) . 








3- Call 




The UICC shall issue a 




isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 




SETUP MENU proactive 




ST) . 




command which contains 
for entry '01 'and entry '02', 
no text part. 


4 


Setting a next action indicator != 

1- Call ChangeMenuEntry { ) with 
parameters : 

Id = '02' 

MenuEntry = "NextActionlndic" 

Offset = 

Length = menuEntry . length 

NextAction = '10' {SETUP CALL) 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


1 - No exception shall be thrown. 






2- Call isEventSet {EVENT_MENU_SELECTION) . 


2- Shall return true. 

3- Shall return false. 






3- Call 








isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 








ST) . 








4- Call ChangeMenuEntry { ) with parameters: 








Id = '02' 








MenuEntry = "NextActionlndic" 








Offset = 




The UICC shall issue a 




Length = menuEntry . length 
NextAction = '10' {SETUP CALL) 




SETUP MENU proactive 




HelpSupported = true 




command which contains an 




IconQualif ier = 




Items Next Action Indicator 




Iconldentif ier = 




list and which contains a 
command qualifier '80'. 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Checking applet is triggered by a 








MENU_SELECTION_HELP_REQUEST 


Applet is triggered by a 








MENU_SELECTION_HELP_REQU 






Send ENVELOPE {MENU_SELECTION_HELP_REQUEST) 


EST and the Item Identifier is 02 






with Item Identifier = ' 02 ' 






6 


help supported=true 

1- Call changeMenuEntry { ) with 
parameters : 

Id = ' 01 ' 








MenuEntry = "HelpSupported" 


1 - No exception sliall be thrown. 






Offset = 








Length = menuEntry. length 


2- Shall return true. 






NextAction = 








HelpSupported = true 


3- Shall return true. 






IconQualif ier = 








Iconldentif ier = 








2- Call isEventSet {EVENT_MENU_SELECTION) . 








3- Call 




The UICC shall issue a 




isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 




SETUP MENU proactive 




ST) . 




command which contains a 
command qualifier '80'. 


7 


Checking applet is triggered by a 








MENU_SELECTION_HELP_REQUEST 


Applet is triggered by a 








MENU_SELECTION_HELP_REQU 






Send ENVELOPE {MENU_SELECTION_HELP_REQUEST) 


EST and the Item Identifier is 01 






with Item Identifier = '01' 






8 


Setting icons, help supported = false 

1- call ChangeMenuEntry { ) for entries 
' 01 ' , ' 02 ' , with parameters : 

Id = '01'/' 02' 

MenuEntry = "IconQualif ier" 








Offset = 


1 - No exception shall be thrown. 






Length = menuEntry . length 








NextAction = 
HelpSupported = false 


2- Shall return true. 






IconQualif ier = '01' 








Iconldentif ier = '02' / '01' 


3- Shall return false. 






2- Call isEventSet {EVENT_MENU_SELECTION) . 








3- Call 




The UICC shall issue a 




isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 




SETUP MENU proactive 




ST) . 




command which contains an 
Icon Identifier List. 


9 


MenuEntry is disabled 

1- Call disableMenuEntry{ ' 01' ) . 

2- Call ChangeMenuEntry { ) with 
parameters : 








Id = '01' 


1 - No exception shall be thrown. 






MenuEntry = "EnableEntry" 








Offset = 


2- No exception shall be thrown. 






Length = menuEntry . length 








NextAction = 


3- Shall return true. 






HelpSupported = false 








IconQualif ier = 


4- Shall return false. 






Iconldentif ier = 




The UICC shall issue a 




3- Call isEventSet {EVENT_MENU_SELECTION) . 




SETUP MENU proactive 
command which contains 




4- Call 




the entry. Without Icon 




isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 




identifier List 




ST) . 




Comprehension TLV 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


MenuEntry is null 

Call ChangeMenuEntry { ) method with 
parameters : 
MenuEntry = NULL 


Shall throw 
java.lang.NullPointerException. 




11 


Offset causes access outside array bounds 

ChangeMenuEntry { ) 
Id = '01' 

MenuEntry = "Violation" 
Offset = menuEntry . length +1 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




12 


Big Offset causes access outside array bounds 

ChangeMenuEntry { ) 
Id = '01' 

MenuEntry = "Violation" 
Offset = 255 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




13 


Offset < causes access outside array bounds 

ChangeMenuEntry { ) 
Id = '01' 

MenuEntry = "Violation" 
Offset = -1 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




14 


Length causes access outside array bounds 

ChangeMenuEntry { ) 

Id = '01' 

MenuEntry = "Violation" 

Offset = 

Length = MenuEntry . length + 1 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = . 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




15 


Length < causes access outside array 
bounds 

ChangeMenuEntry { ) 
Id = '01' 

MenuEntry = "Violation" 
Offset = 
Length = -1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = . 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




16 


Both offset and length causes access outside 
array bounds 

ChangeMenuEntry { ) 
Id = '01' 

MenuEntry = "Violation" 
Offset e [1, MenuEntry. length] 
Length = MenuEntry . length 
NextAction = 1 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Invalid ID used 

ChangeMenuEntry { ) 

Id = '00' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitExceptlon with 
MENU_ENTRY_NOT_FOUND 
reason code. 




18 


ID isn't allocated to a menu entry of this applet 
instance 

ChangeMenuEntry { ) 

Id = ' OA' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitExceptlon with 
reason code: 
MENU_ENTRY_NOT_FOUND. 




19 


The text is bigger than the allocated space 

ChangeMenuEntry { ) 

Id = '02' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length > 15 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitExceptlon with 
reason code: 
ALLOWED_LENGTH_EXCEEDED. 




20 


With a smaller text length than the initial length 

1. ChangeMenuEntry {) with parameters: 

Id = '02' 

MenuEntry = "Init" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

2. Call isEventSet {EVENT_MENU_SELECTION) 

3. Call 

isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1 . No exception shall be thrown. 

2. Shall return true. 

3. Shall return false. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 



5.2.8.3 Method clearEvent 

Test Area Reference: Api_2_Tkr_Cevt. 

5.2.8.3.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent {short event) 

throws ToolkitExceptlon, 

j avacard . framework . TransactionException 



ETSI 



Release 6 



326 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.8.3.1.1 Normal execution 

• CRRNl: A call to isEventSet() method for a cleared event shall return false after a call to clearEvent. 

• CRRN2: The CAT Runtime Environment shall not trigger the applet on the occurrence of the cleared event 
anymore. 

• CRRN3: After the call to clearEvent() method with EVENT_CALL_CONTROL_BY_NAA event, no applet is 
registered to this event, and the CAT Runtime Environment shall allow an applet to register to this event. 

• CRRN4: If an applet is still registered to EVENT_CALL_CONTROL_BY_NAA event, the CAT Runtime 
Environment shall not allow an applet to register to it. 



5.2.8.3.1.2 



Parameter errors 



CRRPl: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_MENU_SELECTION. 

CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP3: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_TIMER_EXPIRATION. 

CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_STATUS_COMMAND. 

CRRP5: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event is 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION. 



5.2.8.3.1.3 



Context errors 



CRRCl: shall throw javacard.framework.TransactionException - if the operation would cause the commit 
capacity to be exceeded. 



5.2.8.3.2 

Test Source: 
Test Applet: 



Test area files 

Test_Api_2_Tkr_Cevt.j ava. 
Api_2_Tkr_Cevt_ 1 .j ava. 



As default but applet registers to an event list which contains all defined events in TS 102 241 [9] excepted 
those that are not allowed or supported by setEvent(). 



Cap File: 
5.2.8.3.3 



api_2_tkr_ce vt . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


4 


N3 


Tested in CAT Runtime Environment, Cre Apt Eccn 


N4 


Tested in CAT Runtime Environment, Cre Apt Eccn 


P1 


3 


P2 


3 


P3 


3 


P4 


3 


P5 


3 


C1 


not testable 
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5.2.8.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear ALLOWED unregistered events 

For events ranging from -1, 1, 7 to 9, 11 
to 23, 25 to 29, 123, 124, 126 and 127* 
excepted those that aren't allowed {7, 8, 
11, 19, 27), the applet calls: 

1- Call clearEventO method 

2- Call isEventSetO method 


1 - No exception is tlirown each 
time. 

2- Sliall return false each time. 




2 


Clear registered events 

1- For each ALLOWED and SUPPORTED event 
{-1, 1, 7 to 9, 11 to 23, 25 to 29, 123, 
124, 126 and 127)* excepted {7, 8, 11, 19, 
27, 124), the applet calls setEventO 
method. Call registerFileEvent { ) method. 

2- For each ALLOWED and SUPPORTED event 
{-1, 1, 7 to 9, 11 to 23, 25 to 29, 123, 
124, 126 and 127)* excepted {7, 8, 11, 19, 
27), the applet calls: 

2.1- Call ClearEventO method 

2.2- Call isEventSetO method 


1 - No exception shall be thrown. 

2.1- No exception shall be thrown. 

2.2- Shall return false. 




3 


Clear NOT ALLOWED events 

For each event among: 
EVENT MENU SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND , 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION, 
1- The applet calls clearEvent (event) 
method. 


1- Each time, clearEvent shall 
throw a ToolkitException with 
reason EVENT_NOT_ALLOWED. 




4 


Check applet is not triggered by an 

ENVELOPE(EVENT EVENT DOWNLOAD USE 

R_ACTIVITY) command 

1 - reset and initialize the card 

2 - An 

ENVELOPE { EVENT_EVENT_DOWNLOAD_USER_ACTIVIT 
Y) is sent. 


Applet is not triggered by an 
ENVELOPE(EVENT EVENT DO 
WNLOAD_USER_ACTIVITY) 
command 





NOTE: Although the clearEventO method is defined for large range, only the allowed events are tested here, 
because a range is reserved for propriatary use in TS 102 241 [9], clause 4, and a range is omitted for 
compatibility with future releases of TS 102 241 [9]. 

5.2.8.4 Method disableMenu Entry 

Test Area Reference: Api_2_Tkr_Dmet. 

5.2.8.4.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry {byte id) 

throws ToolkitException 

5.2.8.4.1.1 Normal execution 

• CRRNl : This method does not modify the registration state to the EVENT_MENU_S ELECTION. 

• CRRN2: This method does not modify the registration state to the 
EVENT_MENU_SELECTION_HELP_REQUEST. 
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• CRRN3: After invocation of this method, during the current card session, the CAT Runtime Environment shall 
dynamically update the menu stored in the ME. 

• CRRN4: After invocation of this method, if there is no more enabled menu entries then the CAT Runtime 
Environment shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV 
with a length of zero and no value part. 



5.2.8.4.1.2 

No requirements. 

5.2.8.4.1.3 



Parameter errors 



Context errors 



• CRRCl : shall throw a ToolkitException with reason ENTRY_NOT_FOUND if the menu entry does not exist 
for this applet. 



5.2.8.4.2 Test area files 

Test Source: Test_Api_2_Tkr_Dmet.java. 
Test Applet: Api_2_Tkr_Dmet_l.java. 

Cap File: api_2_tkr_dmet.cap. 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 

■ Maximum number of menu entries: 

■ Position / Identifier for each menu entry: 

• Additional requirements for the UICC personalization: 

content of EF sume shall be: 

■ Title Alpha Identifier: 



15. 

2. 

'Ol'/'Or, '02702'. 



"TOOLKIT TEST". 



5.2.8.4.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


2,4 


N4 


4 


CI 


5 
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5.2.8.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- reset and initialize the card 

2- Call isEventSet {EVENT MENU SELECTION) 

3- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 


1- Shall return true 

2- Shall return false 


1- The UICC shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


2 


Check the menu state after 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call disableMenuEntry{ ' 01' ) 

2- Call isEventSet {EVENT MENU SELECTION) 

3- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


3 


Check the menu before 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- Call isEventSet {EVENT MENU SELECTION) 

3- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 


2- Shall return true 

3- Shall return true 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call disableMenuEntry{ '02' ) 

2- Call isEventSet {EVENT MENU SELECTION) 

3- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with 1st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
disableMenuEntry {ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





5.2.8.5 Method enableMenuEntry 

Test Area Reference: Api_2_Tkr_Emet. 

5.2.8.5.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry {byte id) 

throws ToolkitException 
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5.2.8.5.1.1 



Normal execution 



CRRNl: A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before 
and after the call to enableMenuEntryO method. 

CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the 
same result before and after the call to enableMenuEntryO method. 

CRRN3:The CAT Runtime Environment shall dynamically issue a SETUP MENU proactive command which 
does contain an ITEM COMPREHENSION TLV object for this entry. 



5.2.8.5.1.2 

No requirements. 

5.2.8.5.1.3 



Parameter errors 



Context errors 



• CRRCl : shall throw a ToolkitException with reason MENU_ENTRY_NOT_FOUND if the menu entry 
doesn't exist for this applet. 

5.2.8.5.2 Test area files 

Additional requirements for the UICC personalization: 

• content of EF sume shall be: 

Title Alpha Identifier: "TOOLKIT TEST". 

Test Source: Test_Api_2_Tkr_Emet.java. 

Test Applet: Api_2_Tkr_Emet_l.java. 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 15. 

■ Maximum number of menu entries: 2. 

■ Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02'. 
Cap File: api_2_tkr_emet.cap. 



5.2.8.5.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


1,2,3,4 


C1 


5 
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5.2.8.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Checl< menu state before 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call isEventSet {EVENT MENU SELECTION) 

2- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 

3- Call disableMenuEntry{ ' 01' ) 


1- Shall return true 

2- Shall return false 

3- No exception shall be thrown. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


2 


Check menu state after 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call enableMenuEntry { ' 01 ' ) 

2- Call IsEventSet {EVENT MENU SELECTION) 

3- Call 

IsEventSet {EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


3 


Check menu state before 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- Call isEventSet {EVENT MENU SELECTION) 

3- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 

4- Call disableMenuEntry{ ' 02' ) 


2- Shall return true 

3- Shall return true 

4- No exception shall be thrown 


4- The UICC shall issue a 
SET UP MENU proactive 
command with entry '01'. 


4 


Check menu state after 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Call enableMenuEntry {' 02 ') . 

2- Call isEventSet {EVENT MENU SELECTION) 

3- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The UICC shall issue a 
SET UP MENU proactive 
command with entries '01' 
and '02' indicating help 
supported. 


5 


Enabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
enableMenuEntry {ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





5.2.8.6 Method getPolllnterval 

Test Area Reference: Api_2_Tkr_Gpol. 

5.2.8.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getPolllnterval { ) 

5.2.8.6.1.1 Normal execution 

• CRRN 1 : shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND 
event. 

• CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT_STATUS_COMMAND event. 
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5.2.8.6.1.2 

No requirements. 

5.2.8.6.1.3 

No requirements. 

5.2.8.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.6.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Tkr_Gpol.j ava. 
Api_2_Tkr_Gpol_l .Java. 
api_2_tkr_gpol.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


1,4 



5.2.8.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet isn't registered to 
EVENT_STATUS_COMIVIAND 

Call getPolllntervalQ method. 


Shall return 0. 




2 


Requesting max duration 

1- Call requestPollInterval (15300) 

2- Reset and initialize the card 

3- Call getPollInterval method 


1 - No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

1- Call 

requestPollInterval (POLL_SYSTEM_DURATION) 

2- Reset and initialize the card 

3- Call getPollInterval method. 


1 - No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 




4 


Requesting no Duration 

1- Call 

requestPollInterval (POLL_NO_DURATION) 

2- Reset and initialize the card 

3- Call getPollInterval method. 


1 - No exception shall be thrown. 
3- Shall return 0. 
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5.2.8.7 Method initMenuEntry 

Test Area Reference: Api_2_Tkr_Imet. 

5.2.8.7.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte initMenuEntry {byte [] menuEntry, 

short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier, 
short iconldentif ier) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.8.7.1.1 Normal execution 

• CRRNl: The CAT Runtime Environment shall automatically update the menu stored in the ME by issuing a 
SETUP MENU proactive command. The later will reflect the changes done for the entry. The CAT Runtime 
Environment shall use the data of the EFsume file in order to build the SET UP MENU command. 

• CRRN2: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true after the 
1^' successful call (without an exception). 

• CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

• CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the UICC for this entry, then 
the CAT Runtime Environment shall trigger the applet. 

• CRRN5: if help supported was true, the CAT Runtime Environment shall issue a SETUP MENU command 
with command qualifier = '80'. 

• CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

• CRRN7: The CAT Runtime Environment shall supply in the SET UP MENU command with the icon 
identifier provided in the icon identifier list within the item icon identifier list Comprehension TLV if all the 
applets registered to the EVENT_MENU_SELECTION provide it. 

• CRRN8: The CAT Runtime Environment shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

• CRRN9: If Next Action Indicator was different from '00', the CAT Runtime Environment shall issue a SETUP 
MENU proactive command containing an Items Next Action Indicator Comprehension TLV with the 
comprehension flag set to 0. 

• CRRN 10: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the UICC for this identifier, then the CAT Runtime Environment shall trigger the 
applet. 

5.2.8.7.1 .2 Parameter errors 
CRRPl: Shall throw java.lang.NuUPointerException - if menuEntry is null. 



• 



• 



• 



CRRP2: Shall throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds. 

CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds. 
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• CRRP4:Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause 
access outside array bounds. 



5.2.8.7.1.3 



Context errors 



• CRRC 1 : Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

• CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialized (eg no more item data in 
applet loading parameter). 

5.2.8.7.2 Test area files 

Additional requirements for the UICC personalization: 

• content of EFsume shall be: 

Tide Alpha Identifier: "TOOLKIT TEST" 
Test case trigger: 

■ 1- Applet instanciation. 

■ 2- Menu selection. 

■ 3- Menu selection Help Supported. 

Test Source: Test_Api_2_Tkr_Imet.java 

Test Applet: Api_2_Tkr_Imet_l.java. 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 15. 

■ Maximum number of menu entries: 6. 

Position / Identifier for each menu entry: 'Ol'/'Ol', '02702', '03'/'03', '04'/'04', '05'/'05', and '06'/'06'. 
Cap File: api_2_tkr_imet.cap. 



5.2.8.7.3 



Test coverage 



CRR number 


Test case number 


N1 


16 


N2 


9 


N3 


11 


N4 


22 


N5 


11, 16 


N6 


10 


N7 


12,16 


N8 


12,16 


N9 


13,16 


N10 


9, 10, 11, 12, 13, 14, 17, 18, 19,20,21,23 


P1 


1 


P2 


2, 3,4 


P3 


5,6 


P4 


7 


01 


8 


C2 


14 
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5.2.8.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

initMenuEntry { ) 
MenuEntry = NULL 


Shall throw a 
java.lang.NullPointerException. 




2 


Offset > menuEntry.length 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




3 


Offset < 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = -1 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




4 


Offset = 255 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = 255 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




5 


Length = menuEntry.length+1 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




6 


Length < 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = 
Length = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




7 


Offset + length > menuEntry.length 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

initMenuEntry { ) 

MenuEntry = "ToolkitTest impossible" 

Offset = 

Length = 16 


ALLOWED_LENGTH_EXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- Call initMenuEntry {) method 

MenuEntry = "TOOLKIT TEST 1" 
Offset = 
Length = 14 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- Call isEventSet {EVENT MENU SELECTION) 


1- No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Successful call, 
menuEntry part of a buffer 

1- Call initMenuEntry {) method 

MenuEntry = "1234567TOOLKIT TEST 2" 

Offset = 7 

Length = 14 

NextAction = ' 00 ' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 

2- Call 

isEventSet {EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1- No exception shall be 
thrown, Shall return ID '02'. 

2- Shall return false. 




11 


Successful call, 
menuEntry with help supported 

1- Call initMenuEntry { ) method 

MenuEntry = "TOOLKIT TEST 3" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = true 
IconQualif ier = '00' 
Iconldentif ier = 

2- Call 

isEventSet {EVENT MENU SELECTION HELP REQUE 
ST) 


1- No exception shall be thrown, 
Shall return ID '03' 

2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

initMenuEntry { ) 

MenuEntry = "TOOLKIT TEST 4" 

Offset = 

Length = 14 

NextAction = ' 00 ' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1- No exception shall be thrown. 

2- Shall return ID '04' 




13 


Successful call, 
menuEntry with a next action indication 

initMenuEntry { ) 

MenuEntry = "TOOLKIT TEST 5" 

Offset = 

Length = 14 

NextAction = '24' [Select Item] 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


1- No exception shall be thrown. 

2- Shall return ID '05' 




14 


Successful call, 
length = 

Call initMenuEntry { ) method 

MenuEntry = "ToolJcitTest" 
Offset = 
Length = 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown, hall 
return ID '06'. 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Initialize more entry than allocated at loading 

initMenuEntry { ) 
MenuEntry = "ToolkitTest" 
Offset = 
Length = 11 


REGISTRY_ERROR 
ToolkitException is thrown. 




16 


Dynamic update of the menu stored by the ME 

Fetch the setup menu proactive command 




Card shall send a 

SetUpMenu Proactive 

command: 

[CommandOualifier]=help 

supported 

[Alphald]="TOOLKIT TEST" 

[ltemld=1] = "TOOLKIT 

TEST 1 " 

[ltemld=2] = "TOOLKIT 

TEST 2" 

[ltemld=3] = "TOOLKIT 

TEST 3" 

[ltemld=4] = "TOOLKIT 

TEST 4" 

[ltemld=5] = "TOOLKIT 

TEST 5" 

[ltemld=6] = "" 

[ltemsNextAction]=0600000 

0002400 


17 


Check Applet is triggered by 
envelope(MENU_SELECTION) command 

Menu Entry ID = ' 01 ' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '01' 




18 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = ' 02 ' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '02' 




19 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = ' 03 ' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '03' 




20 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = ' 04 ' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '04' 




21 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = ' 05 ' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '05' 




22 


Check Applet is triggered by envelope 

(MENU_SELECTION_HELP_REQUEST) 

command 

Menu Entry ID = ' 03 ' 


Applet is triggered by an 
ENVELOPE(MENU SELECTION 
HELP_REQUEST) command & 
Menu Entry ID = '03' 




23 


Check Applet is triggered by envelope 
(MENU_SELECTION) command 

Menu Entry ID = ' 06 ' 


Applet is triggered by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '06' 





ETSI 



Release 6 



338 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.8.8 Method isEventSet 

Test Area Reference: Api_2_Tkr_Ievs. 

5.2.8.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public boolean isEventSet {short event) 

5.2.8.8.1.1 Normal execution 

• CRRNl : shall return true if the event is set in the Toolkit Registry for the applet. 

• CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet. 

5.2.8.8.1 .2 Parameter errors 
No requirements. 

5.2.8.8.1.3 Context errors 
No requirements. 

5.2.8.8.2 Test area files 

Test Source: Test_Api_2_Tkr_Ievs.java 
Test Applet: Api_2_Tkr_Ievs_l.java 

Api_2_Tkr_Ievs_2.j ava 

• Installation parameter: 

Same as default applet but with: 

■ Maximum text length for a menu entry: 15. 

■ Maximum number of menu entries: 1 . 

■ Position / Identifier for each menu entry: 'Ol'/'Ol'. 

■ Maximum number of timers: 1. 
api_2_tkr_ie vs . cap . 



Cap File: 
5.2.8.8.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7 


N2 


1,4,5,6,7,8,9 
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5.2.8.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Install Appletl only registered to 

EVENT UNRECOGNIZED ENVELOPE and 

EVENT_MENU_SELECTION 








Test that events aren't set 


Shall return false each time. 






Applet calls isEventSetO method for each event 








ranging from (-1, 1, 7 to 9, 11 to 23, 25 to 29, 








123, 124, 126 and 127)* excepted 








EVENT UNRECOGNIZED ENVELOPE (-1) and 








EVENT MENU SELECTION (7) . 






2 


For 








EVENT_UNRECOGNIZED_ENVELOPE 


Shall return true. 






Call isEventSet (EVENT UNRECOGNIZED ENVELOPE) 






3 


For EVENT_MENU_SELECTION 

Call isEventSet (EVENT MENU SELECTION) 


Shall return true 




4 


After clearing EVENT_UNRECOGNIZED_ENVELOPE 

1- Call clearEvent (EVENT UNRECOGNIZED ENVELOPE) 


1 - No exception shall be thrown. 






2- Call isEventSet (EVENT UNRECOGNIZED ENVELOPE) 


2- Shall return false. 




5 


Setting events 

For all allowed events defined in ETSI TS 102 

241 [9] for setEvent method: 

EVENT PROFILE DOWNLOAD, 

E VENT_CALL_CONTROL_B Y_NAA , 

EVENT_EVENT_DOWNLOAD_MT_CALL , 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE, 

EVENT EVENT DOWNLOAD CARD READER STATUS, 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION, 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE, 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOL0GY_CHANGE, 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED, 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE, 

EVENT_EVENT_DOWNLOAD_BROWS ING_STATUS , 

EVENT PROACTIVE HANDLER AVAILABLE, 

EVENT_APPLICATION_DESELECT , 

EVENT_FIRST_COMMAND_AFTER_ATR , 

EVENT^UNRECOGNI ZED_ENVELOPE 

applet calls: 








1- Call setEvent method 


1- No exception shall be thrown. 






2- Call isEventSet method 


2- Shall return true each time. 




6 


ForEVENT_MENU_SELECTION_HELP_REQUEST 








1- Call 


1- Shall return false. 






isEventSet (EVENT_MENU_SELECTION_HELP_REQUEST) 








2- Call changeMenuEntry ( ) with help supported 








3- Call 

isEventSet (EVENT MENU SELECTION HELP REQUEST) 


2- Shall return true. 




7 


For EVENT_TIMER_EXPIRATION 








1- Call isEventSet (EVENT TIMER EXPIRATION) 


1- Shall return false. 






2- Call allocateTimer 

3- Call isEventSet (EVENT_TIMER_EXPIRATION) 


3- Shall return true. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


For EVENT_STATUS_COMMAND 

Call i£5EventSet (EVENT_STATUS_COMMAND) 

Call requestPollInterval (POLL_SYSTEM_DURATION) 

Call isEventSet (EVENT STATUS COMMAND) 


1- Shall return false. 
3- Shall return true. 




9 


For 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

1- Call isEventSet 

( E VENT_E VENT_DOWNLOAD_LOCAL_CONNECT I ON ) 

2- Call allocateServiceldentif ier ( ) 

3- Call isEventSet 

(EVENT EVENT DOWNLOAD LOCAL CONNECTION) 


1- Shall return false. 
3- Shall return true. 




10 


Install Applet2 only registered to 
EVENT_MENU_SELECTION 

Call isEventSet (EVENT_UNRECOGNIZED_ENVELOPE) 


Shall return false. 





NOTE: Although the method isEventSet() is defined for a large range only the allowed events are tested, because 
a range is reserved for propriatary use in TS 102 241 [9], clause 4, and a range is omitted for 
compatibility with future releases of TS 102 241 [9]. 

5.2.8.9 Method releaseTimer 

Test Area Reference: Api_2_Tkr_Rtim. 

5.2.8.9.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void releaseTimer (byte timerldentif ier) 
throws ToolkitException 

5.2.8.9.1.1 Normal execution 

• CRRNl: Release a Timer that has been allocated to the calling applet. 

• CRRN2: After invocation of the method the indicated timer shall be released and available for reallocation. 

• CRRN3: The applet is deregistered of the EVENT_T1MER_EXPIRATI0N for the indicated Timer Identifier. 

5.2.8.9.1 .2 Parameter errors 

• CRRP 1 : shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer identifier isn't 
between 1 and 8. 



5.2.8.9.1.3 



Context errors 



• CRRC 1 : shall throw a ToolkitException with INV ALID_TIMER_ID reason if the timer is not allocated to this 
applet. 

5.2.8.9.2 Test area files 

Test Source: Test_Api_2_Tkr_Rtim.java. 
Test Applet: Api_2_Tkr_Rtim_l.java. 

Cap File: api_2_tkr_rtim.cap. 

• Installation parameter: 

As Default, except max timer which is set to 8. 
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5.2.8.9.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3,4 


N2 


5,6 


N3 


7 


N4 


7 


P1 


1,3 


C1 


CAT Runtime Environment, Cre Pes Pcco 



5.2.8.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Release not allocated timers 

For each timer ID ranging from '00' to 
'FF', applet calls releaseTimer (ID) 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_TIMER_ID. 




2 


Release allocated timers 

1- Call 8 times allocateTimer { ) 

2- Call 7 times releaseTimer (id) 

3- Call isEventSet {EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Release invalid timer ID 

1- Call releaseTimer {' FF' ) method 

2- Call isEventSet {EVENT_TIMER_EXPIRATION) 


1 - Shall throw a ToolkitException 
with INVALID_TIMER_ID reason 
code. 

2- Shall return true. 




4 


Release last timer 

1- Call releaseTimer {last timer allocated) 

2- Call isEventSet {EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Check we can allocate timers after they have 
been released 

Call 8 times allocateTimer { ) method 


No exception shall be thrown. 




6 


Release all timers 

For 1 to 8, Call releaseTimer (id) 


No exception shall be thrown. 




7 


Check applet is not triggered by 

envelope(EVENT_TIMER_EXPIRATION) 

command 

Send envelope {EVENT TIMER EXPIRATION) 


Applet is not triggered by any 
envelope(EVENT_TIMER_EXPIRA 
TION) command 





5.2.8.10 Method requestPolllnterval 

Test Area Reference: Api_2_Tkr_Rpol. 
5.2.8.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void requestPolllnterval {short duration) 

throws ToolkitException 
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5.2.8.10.1.1 



Normal execution 



CRRNl: If duration is between 1 and 15300 or equal to P0LL_SYSTEM_DURAT10N, the applet registers to 
EVENT_STATUS_COMMAND. 

CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from 
EVENT STATUS COMMAND. 



5.2.8.10.1.2 



Parameter errors 



• CRRPl : the method should throw a ToolkitException with REGlSTRY_ERROR reason if duration is > 15300 
or is < -1 (P0LL_SYSTEM_DURAT10N). 



5.2.8.10.1.3 
No requirements. 

5.2.8.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.10.3 



Context errors 
Test area files 

Test_Api_2_Tkr_Rpol.java. 
Api_2_Tkr_Rpol_ 1 .j ava. 
api_2_tkr_rpol.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


6,7 


PI 


5 



5.2.8.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Request a value between 1 and 15300 s 

1- Call isEventSet {EVENT_STATUS_COMMiyiAND) 

2- Call requestPollInterval (duration) for 
boundaries values: 1, 255, 256, 15300. 

3- Call isEventSet {EVENT_STATUS_COMiyiAND) . 


1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 




2 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is triggered by a STATUS 
command 




3 


Request POLL SYSTEM DURATION 

1- Call isEventSet {EVENT_STATUS_COMMMAND) . 

2- Call 

RequestPollInterval {POLL_SYSTEM_DURATION) . 

3- Call IsEventSet {EVENT_STATUS_COMMAND) . 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 




4 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is triggered by a STATUS 
command 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Request invalid duration 

Call requestPollInterval (duration) for 
following values: 15301, 32767, -2, -32768 


Each time, a ToolkitException with 
REGISTRY_ERROR reason code, 
shall be thrown. 




6 


Request POLL NO DURATION 

1- Call isEventSet {EVENT_STATUS_COMMMAND) 

2- Call 

requestPollInterval {POLL_NO_DURATION) 

3- Call isEventSet {EVENT_STATUS_COMiyiAND) 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 




7 


Check Applet is not triggered by an STATUS 
command. 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is not triggered by a 
STATUS command 





5.2.8.11 Method setEvent 

Test Area Reference: Api_2_Tkr_Sevt 

5.2.8.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void setEvent {short id) 

throws ToolkitException, 

j avacard . framework . TransactionException 

5.2.8.1 1.1.1 Normal execution 

CRRNl: A following call to isEventSet() method with the same event id shall answer true for the applet. 

CRRN2: The CAT Runtime Environment shall trigger the applet if an occurrence of the set event happens. 

CRRN3: the method shall accept all the events defined in TS 102 241 [9] except: 
EVENT_MENU_SELECTION, EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_TIMER_EXPIRATION, EVENT_STATUS_COMMAND, 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTIONandEVENT_EXTERNAL_FILE_UPDATE. 

CRRN4: no exception shall be thrown if the applet registers more than once to the same event. 

CRRN5: all updates in the TooUcitRegistry are atomic. 



5.2 



8.11.1.2 Parameter errors 

CRRPl: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP2: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION. 

CRRP3: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP4: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_TIMER_EXPIRATION. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_STATUS_COMMAND. 

CRRP6: shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION. 
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• CRRP7: shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EXTERNAL_FILE_UPDATE. 



5.2.8.11.1.3 



Context errors 



• CRRC 1 : shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_NAA but another applet is already registered to it. 

• CRRC2: shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if event is 
EVENT_CALL_CONTROL_B Y_NAA but another applet that it is not in selectable state is already registered 
to it. 

• CRRC3: shall throw javacard.framework.TransactionException - if the operation would cause the commit 
capacity to be exceeded. 

• CRRC4: shall throw a ToolkitException with TAR_NOT_DEFINED if the event requests a tag and the applet 
has no TAR defined. 

5.2.8.11.2 Test area files 

Test Source: Test_Api_2_Tkr_Sevt.java. 
Test Applet: Api_2_Tkr_Sevt_l.java. 

Api_2_Tkr_Sevt_2.java. 

Api_2_Tkr_Sevt_3 .j ava. 

Api_2_Tkr_Sevt_4.j ava. 

The load script installs the 4 instances. 
Cap File: api_2_tkr_sevt.cap. 

5.2.8.11.3 Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1, 10, 11 


N3 


2,4,5,6,7,8,9 


N4 


14 


N5 


not testable 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8 


P7 


9 


CI 


12 


C2 


13 


C3 


not testable 


C4 


not testable 
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5.2.8.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 


Appletl Is triggered by envelope 

(EVENT_EVENT_DOWNLOAD_USER_ACTIVITY) 

command. 








Send 


Appletl shall be triggered 






ENVELOPE {EVENT_EVENT_DOWNLOAD_USER_ACTIVITY) 






2 


Set ALLOWED and SUPPORTED events 

1- For all allowed events {-1, 1, 7 to 9, 11 to 
23, 25 to 29, 123, 124, 126 and 127 excepted 7, 
8, 11, 19, 27, 124) defined in ETSI TS 102 241 

EVENT_PROFILE_DOWNLOAD , 














EVENT_CALL_CONTROL_B Y_NAA , 








EVENT_EVENT_DOWNLOAD_MT_CALL , 








EVENT EVENT DOWNLOAD CALL_CONNECTED , 








EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 








EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 








EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 








EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE, 








EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS, 








EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 








EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION, 








EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE, 








EVENT EVENT DOWNLOAD CHANNEL STATUS, 








EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOL0GY_CHANGE, 








EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CHANGED , 








EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE, 








EVENT_EVENT_DOWNLOAD_BROWS ING_STATUS , 








EVENT_PROACTIVE_HANDLER_AVAILABLE, 








EVENT_APPLICATION_DESELECT, 








EVENT_FIRST_COMMAND_AFTER_ATR , 








EVENT_UNRECOGNIZED_ENVELOPE 








1.1- Call clearEvent (event) 


1.1- No exception shall be 
thrown. 






1.2- Call isEventSet (event) 


1.2- Shall return false. 






1.3- Call setEvent (event) 








1.4- Call isEventSet (event) 


1 .3- No exception shall be 
thrown. 






1.5- Call clearEvent (event) 


1.4- Shall return true. 

1 .5- No exception shall be 
thrown. 




3 


Set Event 








Call setEvent (0) 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED reason 
code. 




4 


Set EVENT_MENU_SELECTION 








Call setEvent (EVENT_MENU_SELECTION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




5 


SetEVENT_MENU_SELECTION_HELP_REQUEST 








Call setEvent (EVENT_MENU_SELECTION_HELP_REQUEST) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




6 


Set EVENT_TIMER_EXPIRATION 








Call setEvent (EVENT_TIMER_EXPIRATION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 
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Id 


Description 


API Expectation 


APDU 
Expectation 


7 


Set EVENT_STATUS_COMIVIAND 

Call setEvent {EVENT_STATUS_COMMAND) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




8 


Set 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

Call 

setEvent {EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




9 


Set EVENT_EXTERNAL_FILE_UPDATE 

Call setEvent {EVENT_EXTERNAL_FILE_UPDATE) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




10 


Set EVENT_CALL_CONTROL_BY_NAA 

Call setEvent {EVENT_CALL_CONTROL_BY_NAA) 


No Exception shall be thrown 




11 


Check applet is triggered by envelope 
(CALL_CONTROL_BY_NAA) command 

Trigger Appletl 


Appletl is triggered by an 
ENVELOPE(CALL CONTROL BY 
NAA) 




12 


Applet2 registers to 

EVENT_CALL_CONTROL_BY_NAA but it is already 

assigned to another applet 

Applet2 call setEvent {EVENT_CALL_CONTROL_BY_NAA) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




13 


Applet3 registers to 

EVENT_CALL_CONTROL_BY_NAA 

but it is already assigned to another applet in not 

selectable state 

1- Set Appletl in the lock state 

2- Trigger Applets which calls 

s e t Event { EVENT_CALL_CONTROL_B Y_NAA ) 

3- Set Appletl in the make selectable state 


2- Shall throw a ToolkitException 
with 

EVENT_ALREADY_REGISTERED 
reason code. 




14 


Applet4 registers multiple registration to the same 
event 

1- setEvent { EVENT_EVENT_DOWNLOAD_MT_CALL) 
2 - setEvent { EVENT_EVENT_DOWNLOAD_MT_CALL ) 
3- isEventSet { EVENT_EVENT_DOWNLOAD_MT_CALL) 


1- no exception should be thrown 

2- no exception should be thrown 

3- method should return true 





NOTE: Although the method setEvent is defined for large range only the allowed events are tested, because a 

range is reserved for propriatary use in TS 102 241 [9], clause 4, and a range is omitted for compatibility 
with future releases of TS 102 241 [9]. 

5.2.8.12 Method setEventList 

Test Area Reference: Api_2_Tkr_Sevl. 

5.2.8.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void setEventList {short [] eventList, 

short offset, 
short length) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 

ToolkitException, 

javacard. framework. TransactionException 
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5.2.8.12.1.1 Normal execution 

CRRN 1 : For all events set successfully by this method, sets an event list in the Toolkit Registry entry of the 
applet. 

CRRN2: The CAT Runtime Environment shall trigger the applet if an occurrence of one of the successfully 
registered events happens. 

CRRN3: All updates on the ToolkitRegistry are atomic. 

CRRN4: No exception shall be thrown if the applet registers more than once to the same event. 

5.2.8.12.1.2 Parameter errors 

CRRPl: shall throw a java.lang.NullPointerException if eventList is null. 

CRRP2: shall throw a java.lang.ArraylndexOutOfBoundsException if offset would cause access outside array 
bounds. 

CRRP3: shall throw a java.lang.ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

CRRP4: shall throw a java.lang.ArraylndexOutOfBoundsException if both offset and length would cause 
access outside array bounds. 

CRRP5: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION. 

CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

CRRP9: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

CRRPIO: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION. 

CRRP 1 1 : Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_EXTERNAL_FILE_UPDATE. 

5.2.8.12.1.3 Context errors 

CRRCl: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_NAA but another applet is already registered to it. 

CRRC2: shall throw javacard.framework.TransactionException - if the operation would cause the commit 
capacity to be exceeded. 

CRRC3: shall throw a ToolkitException with TAR_NOT_DEFINED if the eventList contains an event that 
requests a tag and the applet has not at least one TAR value assigned. 

5.2.8.12.2 Test area files 

Test Source: Test_Api_2_Tkr_Sevl.java. 
Test Applet: Api_2_Tkr_Sevl_Ljava. 

Api_2_Tkr_Sevl_2.java. 
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Cap File: 
5.2.8.12.3 



api_2_tkr_sevl. cap . 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


18, 19 






N3 


21 


N4 


22 


P1 


3 


P2 


4,5,6 


P3 


7,8,9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


P10 


16 


P11 


17 


C1 


20 


C2 


not testable 


C3 


not testable 
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5.2.8.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Appletl registering all eventList buffer 

Appletl is triggered by an 

envelope {MENU_SELECTION) {Id = 01) 

EventList = all allowed events {-1, 1, 7 to 9, 11 

to 23, 25 to 29, 123, 124, 126 and 127 excepted 

7, 8, 11, 19, 27, 124) defined in TS 102 241 [9] : 

EVENT_PROFILE_DOWNLOAD , 

EVENT CALL_CONTROL BY NAA, 

EVENT_EVENT_DOWNLOAD_MT_CALL , 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE, 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS, 

EVENT EVENT DOWNLOAD LANGUAGE SELECTION, 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION, 

EVENT_EVENT_DOWNLOAD_DATA_AVAI LABLE , 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOL0GY_CHANGE, 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CHANGED , 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE, 

EVENT_EVENT_DOWNLOAD_BROWS ING_STATUS , 

EVENT_PROACTIVE_HANDLER_AVAILABLE, 

EVENT APPLICATION DESELECT, 

EVENT_FIRST_COMMAND_AFTER_ATR , 

EVENT_UNRECOGNIZED_ENVELOPE 








1- For each event in EventList, clearEvent {event) 


1- No exception shall be 
thrown. 






2- Call setEventList {eventList) 








Offset = 


2- No exception shall be 






Length = eventList . length 


thrown. 






3- For all events in eventList, isEventSet {event) 


3- Each time shall return true. 






4- For each event in EventList, clearEvent {event) 


4- No exception shall be 
thrown. 




2 


Registering part of eventList buffer 








EventList = all allowed events defined in TS 102 


1- No exception shall be 






241 [9] {see test case 1) . 


thrown. 






1- setEventList {eventList , offset, length) 

Offset > 

Length = eventList . lentgh - offset 


2- Each time shall return true 
for events ranging from offset 
to offset+length else shall 
return false. 






2- For all events in eventList: 








Call isEventSet (event) 


3- No exception shall be 
thrown. 






3- For each event in EventList: clearEvent {event) 






3 


Null buffer 


Shall throw a 






setEventList { ) 


java.lang.NullPointerException 






EventList = null 


Exception 




4 


Out of bounds offset 








setEventList { ) 

Offset = eventList . length 

Length = 1 


Shall throw a 

java.lang.ArraylndexOutOfBou 
nds Exception 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Out of bounds and big offset 

setEventList { ) 
Offset = 255 
Length = 1 


Shall throw a 

java.lang.ArraylndexOutOfBou 
nds Exception 




6 


Offset < 

setEventList { ) 
Offset = -1 
Length = 1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




7 


Out of bounds length 

setEventList { ) 

Offset = 

Length = eventList . length + 1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




8 


Out of bounds and big length 

setEventList { ) 
Offset = 
Length = 255 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




9 


Length < 

setEventList { ) 
Offset = 
Length = -1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




10 


Out of bounds offset + Length 

setEventList { ) 

Offset + length > eventList . length + 1 


Shall throw a 

Java.lang.ArraylndexOutOfBou 
nds Exception 




11 


Event 

Call setEventList (eventList) with eventList 
indicating event 


Shall throw a ToolkitException 
with 

EVENT_NOT_SUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList) with eventList 
indicating EVENT_MENU_SELECTION 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 




13 


EVENT_MENU_SELECTION_HELP_REQUEST 

Call setEventList (eventList) with eventList 
indicating EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 




14 


EVENT_TIMER_EXPIRATION 

Call setEventList (eventList) with eventList 
indicating EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException 
with reason code 
EVENT NOT ALLOWED. 




15 


EVENT_STATUS_COMMAND 

Call setEventList (eventList) with eventList 
indicating EVENT_STATUS_COMMAND 


Shall throw a ToolkitException 
with reason code 
EVENT NOT ALLOWED. 




16 


EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

Call setEventList (eventList) with eventList 
indicating EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 




17 


EVENT_EXTERNAL_FILE_UPDATE 

Call setEventList (eventList) with eventList 
indicating EVENT_EXTERNAL_FILE_UPDATE 


Shall throw a ToolkitException 
with reason code 
EVENT_NOT_ALLOWED. 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Sett EVENT_CALL_CONTROL_BY_NAA 

Call setEventList {MonoEventList, 0, 1) with 
MonoEventList containing 
EVENT CALL CONTROL BY NAA 


Shall not throw an exception. 




19 


Check applet is triggered by an ENVELOPE 
(CALL_CONTROL_BY_NAA) 

Reset and initialize the card 
Trigger Appletl 


Applet is triggered by an 
ENVELOPE(CALL CONTROL 
_BY_NAA) 




20 


Applet2 registers to CALL_CONTROL_BY_NAA 
but it is already assigned 

Applet2 is triggered by an 

envelope {MENU_SELECTION) {Id=02) 

1- Call setEventList {MonoEventList, 0, 1) with 

MonoEventList containing 

EVENT_CALL_CONTROL_BY_NAA 


1- Shall throw a 
ToolkitException with 
EVENT_ALREADY_REGISTE 
RED reason code. 




21 


Atomicity 

1- Call setEventList {EVENT_CALL_CONTROL_BY_NAA, 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED) 

2- isEventSet 

{EVENT EVENT DOWNLOAD CALL CONNECTED) 


1- Shall throw a 
ToolkitException with 
EVENT_ALREADY_REGISTE 
RED reason code. 

2- method shallreturn false 




22 


Multiple registration to the same event 

1- setEventList { EVENT_EVENT_DOWNLOAD_MT_CALL , 
EVENT_EVENT_DOWNLOAD_MT_CALL ) 

2- isEventSet { EVENT_EVENT_DOWNLOAD_MT_CALL ) 


1- no exception should be 
thrown 

2- method shall return true 





5.2.8.13 Method allocateServiceldentifier 

Test Area Reference: Api_2_Tkr_Asid. 

5.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte allocateServiceldentif ier { ) 

throws ToolkitException, 

j avacard . framework . TransactionException 

5.2.8.13.1.1 Normal execution 

• CRRNl: The returned service identifier shall be between 00 and 07 inclusive. 

• CRRN2: The returned service identifier shall be different from a previously allocated but not released one. 

• CRRN3: By calling this method the applet is registered to the EVENT_EVENT_ 
DOWNLOAD_LOCAL_CONNECTION of the allocated service. 

• CRRN4: The service identifier is allocated by the applet until it explicitly releases it. 

• CRRN5: When an applet allocates a service identifier, it can issue the proactive command DECLARE 
SERVICE to add or delete a service to the terminal service database. 



5.2.8.13.1.2 
No requirements. 



Parameter errors 
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5.2.8.13.1.3 



Context errors 



CRRCl: Shall throw a ToolkitException with reason NO_SERVICE_ID_AVAILABLE if all the services are 
allocated. 

CRRC2: Shall throw a ToolkitException with reason NO_SERVICE_ID_AVAILABLE if the maximum 
number of services Identifiers have been allocated to this applet according to installation parameter. 



5.2.8.13.2 

Test Source: 
Test Applet: 



Cap File: 
5.2.8.13.3 



Test area files 

Test_Api_2_Tkr_Asid.j ava. 
Api_2_Tkr_Asid_l.java: 8 services. 
Api_2_Tkr_Asid_2.java: 4 services. 
Api_2_Tkr_Asid_3.java: services. 
api_2_tkr_asid.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


1 


N3 


2 


N4 


2 


N5 


Cat Runtime Environment, Cre Pes Pcco 


CI 


3 


C2 


4 



5.2.8.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 services 
(Appletl) 

Appletl is triggered by an 

envelope {EVENT MENU SELECTION) with Item = 01. 

Call 8 times: 

- allocateServiceldentif ier { ) 

- send associated DECLARE SERVICE 

- isEventSet 

{EVENT EVENT DOWNLOAD LOCAL CONNECTION) . 


No exception shall be thrown. 
Service ID returned shall be 
between 00 and 07 inclusive. It 
shall be different after each call. 
Shall return true. 




2 


Check Appletl is triggered by envelope 

(EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTI 

ON) command 

1- Send 8 envelopes 

{EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION) with 
all services id {not in an increase order) . 

2- Call releaseServiceldentif ier {id) with all 
services . 

3- Call isEventSet 

{EVENT EVENT DOWNLOAD LOCAL CONNECTION) method 


1- Appletl shall be triggered each 
time. 

3- returns false. 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Allocate services more than the maximum 

Appletl is triggered by an 

envelope {EVENT_MENU_SELECTION) with Item = 01. 

1- Appletl calls 5 times 
allocateServiceldentif ier { ) method 

Applet2 is triggered by an 

envelope {EVENT_MENU_SELECTION) with Item = 02 

2- Applet2 calls 3 times 
allocateServiceldentif ier { ) method 

3- Applet2 calls 1 more 
allocateServiceldentif ier { ) method 
Appletl is triggered by an 

envelope {EVENT_MENU_SELECTION) with Item = 01. 

4- Appletl releases all its services. 


1- No exception shall be thrown. 
Each time, the returned service 
identifier shall be between '00' and 
'07' inclusive. It shall be different 
after each call. 

Appletl finalizes. 

2- No exception shall be thrown. 
Each time, the returned service 
identifier shall be between '00' and 
'07' inclusive. It shall be different 
after each call it shall be different 
from the ones allocated to 
Appletl . 

3- A ToolkitException with reason 
NO_SERVICE_ID_AVAILABLE 
shall be thrown 

Applet2 finalizes. 

4- No exception is thrown. 
Appletl finalizes. 




4 


Allocate services more than the maximum to this 

applet 

(Applet3 and Applet2) 

Applet3 is triggered by an 

envelope {EVENT_MENU_SELECTION) with Item = 03 

1- Applet3 calls allocateServiceldentif ier { ) 
method . 

Applet2 is triggered by an 

envelope {EVENT_MENU_SELECTION) with Item = 02 

2- Applet2 calls allocateServiceldentif ier { ) 
method 

3- Applet2 calls allocateServiceldentif ier { ) 
again 


1- A ToolkitException with reason 
NO_SERVICE_ID_AVAILABLE 
shall be thrown 

Applet3 finalizes. 

2- No exception shall be thrown. 

3- A ToolkitException with reason 
NO_SERVICE_ID_AVAILABLE 
shall be thrown 





5.2.8.14 Method releaseServiceldentifier 

Test Area Reference: Api_2_Tkr_Rsid. 

5.2.8.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void releaseServiceldentifier {byte serviceldentif ier) 

throws ToolkitException, 

j avacard . framework . TransactionException 

5.2.8.14.1.1 Normal execution 

• CRRNl: Release a Service Identifier that has been allocated to the calling applet. 

• CRRN2: The applet is deregistered of EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION for the 
indicated service identifier. 
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5.2.8.14.1.2 



Parameter errors 



CRRP 1 : shall throw a TooMtException with INV ALID_SERVICE_ID reason if the service identifier is not 
between and 7. 



5.2.8.14.1.3 



Context errors 



CRRCl: shall throw a TooMtException with INVALID_SERVICE_ID reason if the service is not allocated to 
this applet. 



5.2.8.14.2 

Test Source: 
Test Applet: 

Cap File: 
5.2.8.14.3 



Test area files 

Test_Api_2_Tkr_Rsid.j ava. 
Api_2_Tkr_Rsid_l.java: 8 services. 
Api_2_Tkr_Rsid_2.java: 1 service. 
api_2_tkr_rsid.cap. 

Test coverage 



CRR number 


Test case number 


N1 


4,5,6 


N2 


2, 3, 4, 7 


PI 


1,3 


CI 


8 



5.2.8.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Release not allocated services 

Appletl is triggered by 

envelope {EVENT_MENU_SELECTION) with Item = 

1 

For each service ID ranging from '00' to 

' FF ' , applet calls 

releaseServiceldentif ier (ID) 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_SERVICE_ID. 




2 


Release allocated services 

1- Call 8 times 
allocateServiceldentif ier { ) method . 

2- Call 7 times 

releaseServiceldentif ier (id) method with 
id from to 6 . 

3- Call 

isEventSet {EVENT EVENT DOWNLOAD LOCAL CONN 
ECTION) 


1- No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Release invalid service ID 

1- Call releaseServiceldentif ier {' FF' ) 
method 

2- Call 

isEventSet {EVENT_EVENT_DOWNLOAD_LOCAL_CONN 
ECTION) method 


1 - Shall throw a ToolkitException 
with INVALID_SERVICE_ID reason 
code. 

2- Shall return true. 




4 


Release last service 

1- Call releaseServiceldentif ier { ) method 
with id = '07' 

2- Call 

isEventSet{ EVENT_EVENT_DOWNLOAD_LOCAL_CONN 
ECTION) 


1- No exception shall be thrown. 

2- Shall return false. 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Released services can be allocated 

1- Appletl calls 8 times 
allocateServiceldentif ier { ) method . 

2- Appletl calls 

releaseServiceldentif ier { ) method with the 
service Id = 1 

Applet2 is triggered by 

envelope {EVENT MENU SELECTION) with Item = 

2 

3- Applet2 calls 
allocateServiceldentif ier { ) method . 


1- No exception shall be thrown. 

2- No exception shall be thrown. 
Appletl finalizes 

3- No exception shall be thrown, 
the service Id allocated shall be 1 




6 


Release all services 

Appletl is triggered by 

envelope {EVENT_MENU_SELECTION) with Item = 

1 

Appletl calls releaseServiceldentif ier (id) 

method for id and 2 to 7 . 


No exception shall be thrown. 
Appletl finalizes. 




7 


Check Appletl is not triggered by 

envelope(EVENT EVENT DOWNLOAD LOCAL 

_CONNECTION) command 

Send 

envelope {EVENT_EVENT_DOWNLOAD_LOCAL_CONNEC 

TION) 


Appletl is not triggered by an 
ENVELOPE(EVENT EVENT DO 
WNLOAD_LOCAL_CONNECTION) 
command. 
Applet2 is triggered. 




8 


Release invalid service ID 

Appletl is triggered by 

envelope {EVENT_MENU_SELECTION) with Item = 

1 

1- Appletl calls 

allocateServiceldentif ier { ) method 7 
times . 

2- Appletl calls 

releaseServiceldentif ier { ) method with id 
= '01' 


1- No exception shall be thrown, 
the services Id shall be different 
from 01 

2- Shall throw a ToolkitException 
with INVALID_SERVICE_ID reason 
code. 





5.2.8.15 Method registerFileEvent(short event, byte[] baFileList, short sOffsetl , short 
sLengthI , byte[] baADFAid, short sOffset2, byte bLength2) 

Test Area Reference: Api_2_Tkr_Rgfes_Bss_Bsb. 



5.2.8.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void registerFileEvent {short event, 

byte[] baFileList, 
short sOffsetl, 
short sLengthl, 
byte[] baADFAid, 
short sOffset2, 
byte bLength2) 
throws ToolkitException, 

Java . lang.NullPointerException, 
j ava . lang . ArraylndexOutOf BoundsException, 
j avacard . framework . TransactionException, 
j avacard . framework . SystemException 
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5.2.8.15.1.1 Normal execution 

CRRNl: The only event allowed and supported by the method is EVENT_EXTERNAL_FILE_UPDATE. 

CRRN2: The CAT Runtime Environment shall trigger the applet when a elementary file included in the 
baPileList is updated. 

CRRN3: If the path provided indicates a dedicated file (DF), the Applet shall be triggered when an elementary 
file within this dedicated file is updated. 

CRRN4: The baADFAid indicates the Aid of the ADF under which the file is located. 

CRRN5: If baADFAid is null, it indicates that the file is located under the MF and not located under an ADF. 

CRRN6: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return true if the 
registerFileEventO method has been successfully called. 

5.2.8.15.1.2 Parameter errors 

CRRPl: Shall throw a java.lang.NullPointerException if baFileList is null. 

CRRP2: Shall throw a java.lang.ArraylndexOutOfBoundsException if sOffsetl or sLengthl or both would 
cause access outside array bounds. 

CRRP3: Shall throw a java.lang.ArraylndexOutOfBoundsException if sOffset2 or sLength2 or both would 
cause access outside array bounds. 

CRRP4: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP5: Shall throw a javacard.framework.SystemException with ILLEGAL_VALUE reason if bLength2 is 
not in the range of 5 bytes to 16 bytes. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP9: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRPIO: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT_EXTERNAL_FILE_UPDATE. 

5.2.8.15.1.3 Context errors 
No requirements. 

5.2.8.15.2 Test area files 

Test Source: Test_Api_2_Tkr_Rgfes_Bss_Bsb.java. 
Test Applet: Api_2_Tkr_Rgfes_Bss_Bsb_l.java. 

Cap File: api_2_tkr_rgfes_bss_bsb.cap. 
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5.2.8.15.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,3,21,22,23,24 


N3 


2,4 


N4 


3,4 


N5 


1,2 


N6 


1 


P1 


5 


P2 


6,7,8,9, 10 


P3 


11,12,13,14 


P4 


Not testable 


P5 


15 


P6 


16 


P7 


17 


P8 


18 


P9 


19 


P10 


20 



5.2.8.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Register EF under MF 








1- Call isEventSet 


1 - Returns false 






{ EVENT_EXTERNAL_FILE_UPDATE ) method 








2- Call registerFileEvent { ) method with 
parameters : 


2- No exception Is thrown 






event= EVENT EXTERNAL FILE UPDATE 








baFileList="02 3F001111SF03 3F0011116F09" 








baADFAid=null 


3- Returns true 






3- Call isEventSet 








{EVENT_EXTERNAL_FILE_UPDATE) method 








4- Update binary on MF\DFTEST\EFTARU 


4- Applet Is triggered 






5- Increase on MF\DFTEST\EFCARU 


5- Applet Is triggered 






6- Update record on MF\DFTEST\EFLARU 


6- Applet Is not triggered 






7- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 


7- Applet Is not triggered 






8- Call deregisterFileEvent { ) method with 








parameters : 








event = EVENT EXTERNAL FILE UPDATE 








baFileList="02 3F001111GF03 3F0011116F09" 








baADFAid=null 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Register DF under MF 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F001111" 
baADFAid=null 

2- Update binary on MF\DFTEST\EFTARU 

3- Increase on MF\DFTEST\EFCARU 

4- Update record on MF\DFTEST\EFLARU 

5- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F001111" 
baADFAid=null 


1 - No exception is thrown 

2- Applet is triggered 

3- Applet is triggered 

4- Applet is triggered 

5- Applet is not triggered 




3 


Register EF under ADF1 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F007FFF11116F03 
3F007FFF11116F09" 
baADFAid="AID ADFl" 

2- Update binary on ADF1\DFTEST\EFTARU 

3- Increase on ADF1\DFTEST\EFCARU 

4- Update record on ADF1\DFTEST\EFLARU 

5- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent { ) method with 
parameters : 

event= EVENT EXTERNAL FILE UPDATE 
baFileList="02 3F007FFF1111SF03 
3F007FFF11116F09" 
baADFAid="AID ADFl" 


1 - No exception is thrown 

2- Applet is triggered 

3- Applet is triggered 

4- Applet is not triggered 

5- Applet is not triggered 




4 


Register DF under ADFl 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F007FFF1111" 
baADFAid="AID ADFl" 

2- Update binary on ADF1\DFTEST\EFTARU 

3- Increase on ADF1\DFTEST\EFCARU 

4- Update record on ADF1\DFTEST\EFLARU 

5- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F007FFF1111" 
baADFAid="AID ADFl" 


1 - No exception is thrown 

2- Applet is triggered 

3- Applet is triggered 

4- Applet is triggered 

5- Applet is not triggered 

6- No exception is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


NullPointerException Exception 

Call registerFileEvent { ) method with null 
baFileList 


Shall throw a NullPointerException 




6 


sOffsetl >= baFileList.length 

Call registerFileEvent { ) method with 
baFileList.length = 8 
sOffsetl = 8 
sLengthl = 4 


Shall throw a 

Array IndexOutOfBoundsException 




7 


sOffsetl < 

Call registerFileEvent { ) method with 
baFileList.length = 8 
sOffsetl = -1 
sLengthl = 4 


Shall throw a 

Array IndexOutOfBoundsException 




8 


sLengthl > baFileList.lengtfi 

Call registerFileEvent { ) method with 
baFileList.length = 8 
sOffsetl = 
sLengthl = 10 


Shall throw a 

Array IndexOutOfBoundsException 




9 


sOffsetl + sLengtIil > baFileList.length 

Call registerFileEvent { ) method with 
baFileList.length = 8 
sOffsetl = 5 
sLengthl = 4 


Shall throw a 

Array IndexOutOfBoundsException 




10 


sLengthl < 

Call registerFileEvent { ) method with 
baFileList.length = 8 
sOffsetl = 
sLengthl = -1 


Shall throw a 

Array IndexOutOfBoundsException 




11 


sOffset2 >= baFileList.length 

Call registerFileEvent { ) method with 
baADFAid. length = 15 
sOffset2 = 15 
bLength2 = 6 


Shall throw a 

Array IndexOutOfBoundsException 




12 


sOffset2 < 

Call registerFileEvent { ) method with 
baADFAid. length = 15 
sOffset2 = -1 
bLength2 = 6 


Shall throw a 

Array IndexOutOfBoundsException 




13 


sLength2 > baFileList.length 

Call registerFileEvent { ) method with 
baADFAid. length = 15 
sOffset2 = 
bLength2 = 16 


Shall throw a 

Array IndexOutOfBoundsException 




14 


sOffset2 + sLength2 > baFileList.length 

Call deregisterFileEvent { ) method with 
baADFAid. length = 15 
sOffsetl = 10 
bLengthl = 6 


Shall throw a 

Array IndexOutOfBoundsException 




15 


ILLEGAL_VALUE Exception 

1- Call registerFileEvent { ) method with 
baADFAid. length = 18 

sOffset2 = 
bLength2 = 4 

2- Call registerFileEvent { ) method with 
baADFAid. length = 18 

sOffset2 = 
bLength2 = 18 


1 - Shall throw a SystemException 
with ILLEGAL_VALUE reason code 

2- Shall throw a SystemException 
with ILLEGAL_VALUE reason code 




16 


EVENT_MENU_SELECTION not allowed 

Call registerFileEvent { ) method with 
event=EVENT MENU SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call registerFileEvent { ) method with 
event= EVENT MENU SELECTION HELP REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




18 


EVENT_TIMER_EXPIRATION not allowed 

Call registerFileEvent { ) method with 
event=EVENT TIMER EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




19 


EVENT_STATUS_COMMAND not allowed 

Call registerFileEvent { ) method with 
event=EVENT STATUS COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




20 


EVENT_NOT_SUPPORTED Exception 

Call registerFileEvent { ) method with 
event=EVENT PROFILE DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 




21 


Register a deleted and recreated EF under MF 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F03" 
baADFAid=null 

2- Update binary on MF\DFTEST\EFTARU 

3- Delete MF\DFTEST\EFTARU 

4- Create MF\DFTEST\EFTARU 

5- Update binary on MF\DFTEST\EFTARU 

6- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
baFileList="01 3F001111GF03" 
baADFAid=null 


1 - No exception is thrown 

2- Applet is triggered 
5- Applet is triggered 




22 


Register a deleted and recreated DF under MF 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011112211" 
baADFAid=null 

2- Update binary on 
MF\DFTEST\DFSUB_TEST\EFTAA 

3- Delete DFSUB_TEST 

4- Create DFSUB_TEST, create EFTAA 

5- Update binary on 
MF\DFTEST\DFSUB_TEST\EFTAA 

6- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011112211" 
baADFAid=null 


1 - No exception is thrown 
2- Applet is triggered 
5- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


Register a non existing EF under MF 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F00111122112223" 
baADFAid=null 

2- Create MF\DFTEST\DFSUB TEST\EFTNEW 
(2223) 

3- Update binary on 
MF\DFTEST\DFSUB_TEST\EFTNEW 

4- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F00111122112223" 
baADFAid=null 

5- Delete MF\DFTEST\DFSUB TEST\EFTNEW 


1 - No exception is thrown 
3- Applet is triggered 




24 


Register a non existing DF under MF 

1- Call registerFileEvent { ) method with 
parameters : 

event= EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011112212" 
baADFAid=null 

2- Create MF\DFTEST\DFNEW (2212) 

3- Create MF\DFTEST\DFNEW\EFTNEW 

4- Update binary on MF\DFTEST\DFNEW\EFTNEW 

5- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
baFileList="01 3F0011112212" 
baADFAid=null 

6- Delete MF\DFTEST\DFNEW 
7-Restore EFs 


1 - No exception is thrown 

4- Applet is triggered 

5- Applet is triggered 





NOTE: Complementary information about tests 21, 22, 23, 24 can be found in document SCPt040568 in ETSI 

web site. 

5.2.8.16 Method registerFileEvent(short event, FileView aFileView) 

Test Area Reference: Api_2_Tkr_RgfeSo. 

5.2.8.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void registerFileEvent {short event, 

FileView aFileView) 
throws ToolkitException, 

Java . lang. Null Point erExcept ion, 

j avacard . framework . TransactionException 

5.2.8.16.1.1 Normal execution 

• CRRN 1 : The only event allowed and supported by the method is E VENT_EXTERN AL_FILE_UPD ATE. 

• CRRN2: The CAT Runtime Environment shall trigger the applet when the aFileView object's current file is 
updated. 
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5.2 



CRRN3: If the aFileView object's current file is a dedicated file, the Applet shall be triggered when an 
elementary file within this dedicated file is updated. 

CRRN4 : A later change in the File View shall not modify the registration. 

CRRN5: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return true if the 
registerFileEventO method has been successfully called. 

8.16.1.2 Parameter errors 

CRRPl: Shall throw ajava.lang.NuUPointerException if aFileView is null. 

CRRP2: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP3: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP4: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP5: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT_EXTERNAL_FILE_UPDATE. 



5.2.8.16.1.3 
No requirements. 



Context errors 



5.2.8.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.16.3 



Test area files 

Test_Api_2_Tkr_RgfeSo.java. 
Api_2_Tkr_RgfeSo _l.java. 
api_2_tkr_rgfeso .cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,3, 11, 12 


N3 


2,4 


N4 


1,3 


N5 


1 


PI 


5 


P2 


Not testable 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


P7 


10 
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5.2.8.16.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Register EF under MF 



1- Call isEventSet 

{EVENT EXTERNAL FILE UPDATE) method 



2- Call UICCView=getTheUICCView{) 

3- Applet selects MF\DFTEST\EFTARU. 

4- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
aFileView = UlCCView 

5- Update binary on MF\DFTEST\EFTARU 



6- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 

7- Applet selects EFCARU. 

8- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = UlCCView 

9- Update binary on MF\DFTEST\EFTARU 

10- Increase on MF\DFTEST\EFCARU 

11- Update record on MF\DFTEST\EFLARU 

12- Update binary on MF\DFTEST\ 
DFSUB_TEST\EFTAA 

13- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = UlCCView 

14- Applet selects MF\DFTEST\EFTARU. 

15- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
aFileView = UlCCView 



1 - Returns false 



5- Applet is triggered 



6- Returns true 

8- No exception Is thrown 

9- Applet Is triggered 

10- Applet is triggered 

1 1 - Applet is not triggered 
1 2- Applet is not triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Register DF under MF 








1- Applet selects MF\DFTEST. 


2- No exception is thrown 






2- Call registerFileEvent { ) method with 








parameters : 








event= EVENT EXTERNAL FILE UPDATE 








aFileView = UlCCView 


3- Applet is triggered 






3- Update binary on MF\DFTEST\EFTARU 


4- Applet is triggered 






4- Increase on MF\DFTEST\EFCARU 








5- Update record on MF\DFTEST\EFLARU 


5- Applet is triggered 






6- Update binary on MF\DFTEST\ 


6- Applet is not triggered 






DFSUB_TEST\EFTAA 








7- Applet selects MF\DFTEST 








8- Call deregisterFileEvent { ) method with 








parameters : 








event= EVENT EXTERNAL FILE UPDATE 








aFileView = UlCCView 






3 


Register EF under ADF1 

1- Call ADFlView=getTheFileView{) 

2- Applet selects ADF1\DFTEST\EFTARU. 








3- Call registerFileEvent { ) method with 


3- No exception is thrown 






parameters : 








event = EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








4- Update binary on ADF1\DFTEST\EFTARU 


4- Applet is triggered 






5- Applet selects ADF1\DFTEST\EFCARU. 








6- Call registerFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 


6- No exception is thrown 






7- Update binary on ADF1\DFTEST\EFTARU 








8- Increase on ADF1\DFTEST\EFCARU 


7- Applet is triggered 






9- Update record on ADF1\DFTEST\EFLARU 


8- Applet is triggered 






10- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 


9- Applet is not triggered 






11- Applet selects ADF1\DFTEST\EFCARU. 


1 0- Applet is not triggered 






12- Call deregisterFileEvent {) method with 








parameters : 








event = EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








13- Applet selects ADF1\DFTEST\EFTARU. 








14- Call deregisterFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_F I LE_UPDATE 








aFileView = ADFlView 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Register DF under ADF1 

1- Applet selects DFTEST. 

2- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
aFileView = ADFlView 

3- Update binary on ADF1\DFTEST\EFTARU 

4- Increase on ADF1\DFTEST\EFCARU 

5- Update record on ADF1\DFTEST\EFLARU 

S- Update binary on ADF1\DFTEST\ 
DFSUB_TEST\EFTAA 

7- Applet selects ADF1\DFTEST 

8- Call deregisterFileEvent { ) method with 
parameters : 

e vent = EVENT_EXTERNAL_F I LE_UPDATE 
aFileView = ADFlView 


2- No exception is thrown 

3- Applet is triggered 

4- Applet is triggered 

5- Applet is triggered 

6- Applet is not triggered 




5 


NullPointerException Exception 

Call registerFileEvent { ) method with null 
aFileView 


Shall throw a NullPointerException 




6 


EVENT_MENU_SELECTION not allowed 

Call registerFileEvent { ) method with 
event=EVENT MENU SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




7 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call registerFileEvent { ) method with 
event= EVENT MENU SELECTION HELP REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




8 


EVENT_TIMER_EXPIRATION not allowed 

Call registerFileEvent { ) method with 
event=EVENT TIMER EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




9 


EVENT_STATUS_COMMAND not allowed 

Call registerFileEvent { ) method with 
event=EVENT STATUS COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




10 


EVENT_NOT_SUPPORTED Exception 

Call registerFileEvent { ) method with 
event=EVENT PROFILE DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 




11 


Register a deleted and recreated EF under ADF 

1- Applet selects ADFIXDFtestXEFtaeu 

2- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

3- Update binary on ADFl\DFTEST\EFTiEn 

4- Delete ADFl\DFTEST\EFTaEn 

5- Create ADFl\DFTEST\EFTaEn 

6- Update binary on ADFIXDEtestXEFtaeu 

7- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 


2- No exception is thrown 

3- Applet is triggered 

6- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Register a deleted and recreated DF under ADF 








1- Applet selects ADFIXDFtestXDFsubtbst 


2- No exception is thrown 






2- Call registerFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_F I LE_UPDATE 








aFileView = ADFlView 








3- Update binary on ADF1\DFtest\ 


3- Applet is triggered 






DFsub_test\ EFtaa 








4- Delete EFtsa, delete DFsdb_test 








5- Create DFsaB_TEST, create EFtaa 








6- Update binary on ADF1\DFtest\ 
DFsuB test\EFtaa 


6- Applet is triggered 






7- Applet selects ADF1\DFtest\ DFsub_test 








8- Call deregisterFileEvent { ) method with 








parameters : 








event= EVENT_EXTERNAL_FILE_UPDATE 








aFileView = ADFlView 








9- Restore EFs 







NOTE: Complementary information about tests 11,12 can be found in document SCPt040568 in ETSI web site. 

5.2.8.17 Method deregisterFileEvent(short event, byte[] baFileList, short sOffsetl , 
short sLengthI , byte[] baADFAid, short sOffset2, byte bLength2) 

Test Area Reference: Api_2_Tkr_Drfes_Bss_Bsb. 

5.2.8.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deregisterFileEvent {short event, 

byte [] baFileList, 
short sOffsetl, 
short sLengthl, 
byte[] baADFAid, 
short sOffset2, 
byte bLength2) 
throws ToolkitException, 

Java . lang.NullPointerException, 
j ava . lang . ArraylndexOutOf BoundsException, 
j avacard . framework . Transact ionExcept ion, 
javacard. framework. SystemException 

5.2.8.17.1.1 Normal execution 

• CRRN 1 : The only event allowed and supported by the method is EVENT_EXTERNAL_FILE_UPD ATE. 

• CRRN2: The applet is deregistered to the file included in the baFileList. 

• CRRN3: If a file in baFileList is a dedicated file the deregistration shall not affect the monitoring of an 
elementary file within the dedicated file that was individually registered. 

• CRRN4: If a file in baFileList is an elementary file the deregistration will not affect the monitoring of the 
parent dedicated file that was individually registered. 

• CRRN5: The baADFAid indicates the Aid of the ADF under which the file is located. 

• CRRN6: If baADFAid is null, it indicates that the file is located under the MF and not located under an ADF. 
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• CRRN7: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return false if the 
applet has been deregistered completely to all its registered EFs and DFs. 

5.2.8.17.1.2 Parameter errors 

CRRPl: Shall throw a java.lang.NullPointerException if baPileList is null. 

CRRP2: Shall throw a java.lang.ArraylndexOutOfBoundsException if sOffsetl or sLengthl or both would 
cause access outside array bounds. 

CRRP3: Shall throw a java.lang.ArraylndexOutOfBoundsException if sOffset2 or sLength2 or both would 
cause access outside array bounds. 

CRRP4: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP5: Shall throw a javacard.framework.SystemException with ILLEGAL_VALUE reason if bLength2 is 
not in the range of 5 - 16 bytes. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP8: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP9: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRPIO: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT_EXTERNAL_FILE_UPDATE. 

5.2.8.17.1.3 Context errors 
No requirements. 

5.2.8.17.2 Test area files 

Test Source: Test_Api_2_Tkr_Drfes_Bss_Bsb.java. 
Test Applet: Api_2_Tkr_Drfes_Bss_Bsb _l.java. 

Cap File: api_2_tkr_drfes_bss_bsb.cap. 
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5.2.8.17.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


N2 


1,4 


N3 


2,5 


N4 


3,6 


N5 


4,5,6 


N6 


1, 2, 3 


N7 


1 


P1 


7 


P2 


8,9, 10, 11, 12 


P3 


13, 14, 15, 16 


P4 


Not testable 


P5 


17 


P6 


18 


P7 


19 


P8 


20 


P9 


21 


P10 


22 



5.2.8.17.4 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Deregister EF under MF 

1- Call isEventSet 
{EVENT_EXTERNAL_FILE_UPDATE) method 

2- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
baFileList="03 3F0011116F03 3F0011116F09 
3F0011116F0C" 
baADFAid=null 



3- Update binary on MFXDFtestXEFtahu 

4- Increase on MFXDFtestXEFcaeu 

5- Update record on MF\DFtest\EFlaeu 

6- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F0011116F03 3F0011116F09" 
baADFAid=null 

7- Update binary on MFXDFtestXEFtaeu 

8- Increase on MF\DFtest\EFcaeu 

9- Update record on MF\DFtest\EFlaeu 



10- Call isEventSet 
{EVENT_EXTERNAL_FILE_UPDATE) method 

11- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F0C" 
baADFAid=null 

12- Update record on MFXDFtestXEFlaeu 

13- Call isEventSet 

{EVENT EXTERNAL FILE UPDATE) method 



1 - Returns false 



3- Applet is triggered 

4- Applet is triggered 

5- Applet is triggered 

6- No exception is thrown 



7- Applet is not triggered 

8- Applet is not triggered 

9- Applet is triggered 

1 0- Returns true 

1 1 - No exception is thrown 

1 2- Applet is not triggered 

13- Returns false 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Deregister DF does not affect child EF 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
baFileList="02 3F0011116F03 3F001111" 
baADFAid=null 

2- Update binary on MF\DFtest\EFtaru 

3- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F001111" 
baADFAid=null 

4- Update binary on MF\DFtest\EFtaru 


2- Applet is triggered 

3- No exception is thrown 

4- Applet is triggered 




3 


Deregister EF does not affect parent DF 

1- Call registerFileEvent { ) method with 
parameters : 

event= EVENT EXTERNAL FILE^UPDATE 
baFileList="01 3F001111" 
baADFAid=null 

2- Update binary on MFXDFtestXEFtaeu 

3- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="01 3F0011116F03" 
baADFAid=null 

4- Update binary on MFXDFtestXEFtaeu 

5- Update record on MFXDFtestXEFlaeu 


2- Applet is triggered 

3- No exception is thrown 

4- Applet is triggered 

5- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Deregister EF under ADF1 








1- Call isEventSet 


1- Returns false 






{EVENT_EXTERNAL_FILE_UPDATE) method 








2- Call registerFileEvent { ) method with 








parameters : 








event= EVENT EXTERNAL_FILE_UPDATE 








baFileList="03 3F007FFF11116F03 








3F0 7FFF11116F0 9 3F0 7FFF11116F0C" 








baADFAid="AID ADFl" 








3- Update binary on MFXDFtestXEFtaeu 


3- Applet is triggered 






4- Increase on MFXDFtestXEFcaeu 


4- Applet is triggered 






5- Update record on MFXDFtestXEFlaeu 


5- Applet is triggered 






6- Call deregisterFileEvent { ) method with 


6- No exception is thrown 






parameters : 








event = EVENT_EXTERNAL_F I LE_UPDATE 








baFileList="02 3F007FFF11116F03 








3F007FFF11116F09" 








baADFAid="AID ADFl" 








7- Update binary on MFXDFtestXEFtaeu 


7- Applet is not triggered 






8- Increase on MFXDFtestXEFcaeu 


8- Applet is not triggered 






9- Update record on MFXDFtestXEFlaeu 


9- Applet is triggered 






10- Call isEventSet 


1 0- Returns true 






{EVENT_EXTERNAL_FILE_UPDATE) method 








11- Call deregisterFileEvent {) method with 


11 - No exception is thrown 






parameters : 








event = EVENT_EXTERNAL_FILE_UPDATE 








baFileList="01 3F0 7FFF11116F0C" 








baADFAid="AID ADFl" 








12- Update record on MFXDFtestXEFlaeu 


1 2- Applet is not triggered 






13- Call isEventSet 


1 3- Returns false 






{EVENT EXTERNAL FILE UPDATE) method 






5 


Deregister DP does not affect cliild EF (under 
ADFl) 

1- Call registerFileEvent { ) method with 
parameters : 

event= EVENT EXTERNAL FILE UPDATE 
baFileList="02 3F007FFF11116F03 3F001111" 








baADFAid="AID ADFl" 


2- Applet is triggered 






2- Update binary on MF\DFTEST\EFTARU 


3- No exception is thrown 






3- Call deregisterFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_F I LE_UPDATE 








baFileList="01 3F007FFF1111" 








baADFAid="AID ADFl" 








4- Update binary on MF\DFTEST\EFTARU 


4- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Deregister EF does not affect parent DF (under 








ADF1) 


1 - No exception is thrown 






1- Call registerFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_FILE_UPDATE 








baFileList="01 3F007FFF1111" 








baADFAid="AID ADFl" 








2- Update binary on MFXDFtestXEFtaeu 


2- Applet is triggered 






3- Call deregisterFileEvent { ) method with 


3- No exception is thrown 






parameters : 








event= EVENT EXTERNAL FILE UPDATE 








baFileList="01 3F0 7FFF1111SF0 3" 








baADFAid="AID ADFl" 








4- Update binary on MFXDFtestXEFtaeu 

5- Update record on MFXDFtestXEFlaeu 


4- Applet is triggered 

5- Applet is triggered 






6- Restore EFs 






7 


NullPointerException Exception 








Call deregisterFileEvent { ) method with 


Shall throw a NullPointerException 






baFileList null 






8 


sOffsetl >= baFileList.length 








Call deregisterFileEvent { ) method with 


Shall throw a 






baFileList.length = 7 
sOffsetl = 8 


Array IndexOutOfBoundsException 






sLengthl = 4 






9 


sOffsetl < 








Call deregisterFileEvent { ) method with 


Shall throw a 






baFileList.length = 19 
sOffsetl = -1 


Array IndexOutOfBoundsException 






sLengthl = 4 






10 


sLengthl > baFlleList.lengtIi 








Call deregisterFileEvent { ) method with 


Shall throw a 






baFileList.length = 7 
sOffsetl = 


Array IndexOutOfBoundsException 






sLengthl = 10 






11 


sOffsetl + sLengtfil > baFileList.length 








Call deregisterFileEvent { ) method with 


Shall throw a 






baFileList.length = 7 
sOffsetl = 5 


Array IndexOutOfBoundsException 






sLengthl = 4 






12 


sLengthl < 








Call deregisterFileEvent { ) method with 


Shall throw a 






baFileList.length = 7 
sOffsetl = 


Array IndexOutOfBoundsException 






sLengthl = -1 






13 


sOffset2 >= baFileList.length 








Call deregisterFileEvent { ) method with 


Shall throw a 






baADFAid. length = 15 
sOffset2 = 15 


ArraylndexOutOfBoundsException 






bLength2 = 6 






14 


sOffset2 < 








Call deregisterFileEvent { ) method with 


Shall throw a 






baADFAid. length = 15 
sOffset2 = -1 


ArraylndexOutOfBoundsException 






bLength2 = 6 






15 


sLength2 > baFileList.length 








Call deregisterFileEvent { ) method with 


Shall throw a 






baADFAid. length = 15 
sOffset2 = 


ArraylndexOutOfBoundsException 






bLength2 = 16 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


sOffset2+ sLength2 > baFileList.length 

Call deregisterFileEvent { ) method with 
baADFAid. length = 15 
sOffsetl = 10 
bLengthl = 6 


Shall throw a 
ArraylndexOutOfBoundsException 




17 


ILLEGAL_VALUE Exception 

1- Call deregisterFileEvent { ) method with 
baADFAid. length = 18 

sOffset2 = 
bLength2 = 4 

2- Call deregisterFileEvent { ) method with 
baADFAid. length = 18 

sOffset2 = 
bLength2 = 18 


1 - Shall throw a SystemException 
with ILLEGAL_VALUE reason code 

2- Shall throw a SystemException 
with ILLEGAL_VALUE reason code 




18 


EVENT_MENU_SELECTION not allowed 

Call deregisterFileEvent { ) method with 
event=EVENT MENU SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




19 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call deregisterFileEvent { ) method with 
event= EVENT MENU SELECTION HELP REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




20 


EVENT_TIMER_EXPIRATION not allowed 

Call deregisterFileEvent { ) method with 
event=EVENT TIMER EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




21 


EVENT_STATUS_COMMAND not allowed 

Call deregisterFileEvent { ) method with 
event=EVENT STATUS COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




22 


EVENT_NOT_SUPPORTED Exception 

Call deregisterFileEvent { ) method with 
event = EVENT PROFILE DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 





5.2.8.18 Method deregisterFileEvent(short event, FileView aFileView) 

Test Area Reference: Api_2_Tkr_Drfeso. 

5.2.8.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deregisterFileEvent {short event, 

FileView aFileView) 
throws ToolkitException, 

Java . lang. Null Point erExcept ion, 

j avacard . framework . TransactionException 

5.2.8.18.1.1 Normal execution 

• CRRN 1 : The only event allowed and supported by the method is E VENT_EXTERN AL_FILE_UPD ATE. 

• CRRN2: The aFileView object's current file indicates the file that is no longer monitored. The applet is 
deregistered to the aFileView object's current file. 

• CRRN3: If the current file is a dedicated file the deregistration shall not affect the monitoring of an elementary 
file within the dedicated file that was individually registered. 

• CRRN4: If the current file is an elementary file the deregistration will not affect the monitoring of the parent 
dedicated file that was individually registered. 

• CRRN5: A call to isEventSet() method for EVENT_EXTERNAL_FILE_UPDATE should return false if the 
applet has been deregistered completely to all its registered EFs and DFs. 



ETSI 



Release 6 



373 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.8.18.1.2 Parameter errors 

CRRPl: Shall throw ajava.lang.NullPointerException if aFileView is null. 

CRRP2: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

CRRP3: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION. 

CRRP4: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

CRRP5: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_TIMER_EXPIRATION. 

CRRP6: Shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if the event is 
EVENT_STATUS_COMMAND. 

CRRP7: Shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if the event is not 
EVENT EXTERNAL FILE UPDATE. 



5.2.8.18.1.3 
No requirements. 

5.2.8.18.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.8.18.3 



Context errors 
Test area files 

Test_Api_2_Tkr_Drfeso.java. 
Api_2_Tkr_Drfeso_l .Java. 
api_2_tkr_drfeso .cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


N2 


1,4 


N3 


2,5 


N4 


3,6 


N5 


1 


PI 


7 


P2 


Not testable 


P3 


8 


P4 


9 


P5 


10 


P6 


11 


P7 


12 



ETSI 



Release 6 



374 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.8.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Deregister EF under IMF 








1- Call isEventSet 
(EVENT_EXTERNAL_FILE_UPDATE) method 


1 - Returns false 






2- Call registerFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_FILE_UPDATE 








baFileList="03 3F0011116F03 3F0011116F09 








3F0011116F0C" 








baADFAid=null 








3- Update binary on MFXDFtestNEFtahu 


3- Applet is triggered 






4- Increase on MF\DFTEST\EFcaEn 


4- Applet is triggered 






5- Update record on MFXDFtestXEFlaeu 


5- Applet is triggered 






6- Call UICCView=getTheUICCView{) 








7- Applet selects EFtaeu- 








8- Call deregisterFileEvent { ) method with 


8- No exception is tlirown 






parameters : 








event= EVENT EXTERNAL FILE_UPDATE 








aFileView = UlCCView 








9- Update binary on MFXDFtestXEFtaeu 


9- Applet is not triggered 






10- Applet selects EFcaeu. 








11- Call deregisterFileEvent {) method with 








parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 


11 - No exception is thrown 






aFileView = UlCCView 








12- Increase on MFXDFtestXEFcaeu 


1 2- Applet is not triggered 






13- Call isEventSet 


1 3- Returns true 






{EVENT_EXTERNAL_FILE_UPDATE) method 








14- Applet selects EFlaeu- 








15- Call deregisterFileEvent { ) method with 
parameters : 


15- No exception is thrown 






event = EVENT_EXTERNAL_F I LE_UPDATE 








aFileView = UlCCView 








16- Update record on MFXDFtestXEFlaeu 


1 6- Applet is not triggered 






17- Call isEventSet 

{EVENT EXTERNAL FILE UPDATE) method 


1 7- Returns false 




2 


Deregister DF does not affect child EF 

1- Call registerFileEvent { ) method with 

parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 

baFileList="02 3F0011116F03 3F001111" 

baADFAid=null 








2- Update binary on MFXDFtestXEFtaeu 

3- Applet selects DFtest- 


2- Applet is triggered 






4- Call deregisterFileEvent { ) method with 
parameters : 


4- No exception is thrown 






event = EVENT_EXTERNAL_FILE_UPDATE 








aFileView = UlCCView 








5- Update binary on MFXDFtestXEFtaeu 


5- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Deregister EF does not affect parent DF 

l-Select DFtest 

2- Call registerFileEvent { ) method with 

parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 








aFileView = UlCCView 


3- Applet is triggered 






3- Update binary on MFXDFtestXEFtaeu 








4- Applet selects EFtaeu- 








5- Call deregisterFileEvent { ) method with 


5- No exception is thrown 






parameters : 








event= EVENT_EXTERNAL FILE UPDATE 








aFileView = UlCCView 








6- Update binary on MFXDFtestXEFtaeu 

7- Update record on MFXDFtestXEFlaeu 


6- Applet is triggered 

7- Applet is triggered 




4 


Deregister EF under ADF1 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="03 3F007FFF11116F03 
3F0 7FFF11116F0 9 3F0 7FFF1111SF0C" 
baADFAid="AID ADFl" 

2- Update binary on MFXDFtestXEFtaeu 


2- Applet is triggered 






3- Increase on MFXDFtestXEFcaeu 


3- Applet is triggered 






4- Update record on MFXDFtestXEFlaeu 


4- Applet is triggered 






5- Call ADFlView=getTheFileView{) 








6- Applet selects EFtaeu- 








7- Call deregisterFileEvent { ) method with 








parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 


7- No exception is ttirown 






aFileView = ADFlView 








8- Update binary on MFXDFtestXEFtaeu 


8- Applet is not triggered 






9- Applet selects EFcaeu- 








10- Call deregisterFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_F I LE_UPDATE 








aFileView = ADFlView 


1 0- No exception is thrown 






11- Increase on MFXDFtestXEFcaeu 








12- Applet selects EFlaeu- 


1 1 - Applet is not triggered 






13- Call deregisterFileEvent { ) method with 








parameters : 








event = EVENT_EXTERNAL_F I LE_UPDATE 








aFileView = ADFlView 








14- Update record on MF\DFtest\EFlaeu 


13- No exception is thrown 

14- Applet is not triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Deregister DF does not affect child EF (under 
ADF1) 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
baFileList="02 3F007FFF1111SF03 
3F007FFF1111" 
baADFAid="AID ADFl" 

2- Update binary on MFXDFtestXEFtaeu 

3- Applet selects DFtest- 

4- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

5- Update binary on MFXDFtestXEFtaeu 


2- Applet is triggered 

4- No exception is thrown 

5- Applet is triggered 




6 


Deregister EF does not affect parent DF (under 
ADFl) 

1- Call registerFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_FILE_UPDATE 
aFileView = ADFlView 

2- Update binary on MFXDFtestXEFtaeu 

3- Applet selects EFtaeu- 

4- Call deregisterFileEvent { ) method with 
parameters : 

event = EVENT_EXTERNAL_F I LE_UPDATE 
aFileView = ADFlView 

5- Update binary on MFXDFtestXEFtaeu 

6- Update record on MFXDFtestXEFlaeu 

7- Restore EFs 


1 - No exception is thrown 

2- Applet is triggered 

4- No exception is thrown 

5- Applet is triggered 

6- Applet is triggered 




7 


NullPointerException Exception 

Call registerFileEvent { ) method with null 
aFileView 


Shall throw a NullPointerException 




8 


EVENT_MENU_SELECTION not allowed 

Call registerFileEvent { ) method with 
event=EVENT MENU SELECTION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




9 


EVENT_MENU_SELECTION_HELP_REQUEST 
not allowed 

Call registerFileEvent { ) method with 
event= EVENT MENU SELECTION HELP REQUEST 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




10 


EVENT_TIMER_EXPIRATION not allowed 

Call registerFileEvent { ) method with 
event=EVENT TIMER EXPIRATION 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




11 


EVENT_STATUS_COMMAND not allowed 

Call registerFileEvent { ) method with 
event=EVENT STATUS COMMAND 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code 




12 


EVENT_NOT_SUPPORTED Exception 

Call registerFileEvent { ) method with 
event=EVENT PROFILE DOWNLOAD 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code 
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5.2.8.19 Method setMenuEntryTextAttribute 

Test Area Reference: Api_2_Tkr_Smta. 

5.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void setMenuEntryTextAttribute {byte id, 

byte[] textAttribute, 
short offset, 
short length) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 

Toolkit Except ion, 

j avacard . framework . TransactionException 

5.2.8.19.1.1 Normal execution 

• CRRNl: Sets the text attribute of a menu entry. 

• CRRN2: The text attribute provided will be added to the text attribute list of the item text attribute list 
Comprehension TLV. 

• CRRN3: After the invocation of this method, during the current card session, the CAT Runtime Environment 
shall dynamically update the menu stored in the terminal. 

5.2.8.19.1.2 Parameter errors 

• CRRPl: Shall throw a java.lang.NullPointerException if textAttribute is null. 

• CRRP2: Shall throw a Java. lang. ArraylndexOutOfBoundsException if offset or length or both would cause 
access outside array bounds. 

• CRRP3: Shall throw a ToolkitException with MENU_ENTRY_NOT_FOUND reason if the menu entry does 
not exist for this applet. 

• CRRP4: Shall throw a ToolkitException with B AD_INPUT_PARAMETER reason if the length is different 
from 4. 

• CRRP5: Shall throw a javacard.framework.TransactionException if the operation would cause the commit 
capacity to be exceeded. 

5.2.8.19.1.3 Context errors 
No requirements. 

5.2.8.19.2 Test area files 

Test Source: Test_ Api_2_Tkr_Smta.java. 
Test Applet: Api_2_Tkr_Smta _1 .Java. 

Cap File: api_2_tkr_smta.cap. 
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5.2.8.19.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


1,2 


N3 


1,2 


P1 


3 


P2 


4, 5, 6, 7 


P3 


8 


P4 


9 


P5 


Not testable 



5.2.8.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Text attribute update 1 

Call setMenuEntryTextAttribute { ) with 
parameters : 

Id = '02' 

textAttribute= "00 OC 11 02 00 OC 10 03" 

Offset = 

Length = 4 


No exception shall be thrown. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the text Attribute list value 
"00 00 03 90" "00 OC 1 1 02" 
"00 00 03 90" "00 00 03 90" 


2 


Text attribute update 2 

Call SetMenuEntryTextAttribute {) with 
parameters : 

Id = '04' 

textAttribute= "00 OC 11 02 00 OC 10 03" 

Offset = 4 

Length = 4 


No exception shall be thrown. 


The UICC shall issue a 
SETUP MENU proactive 
command which contains 
the text Attribute list value 
"00 00 03 90" "00 OC 1 1 02" 
"00 00 03 90" "00 0C1 03" 


3 


Call setMenuEntryTextAttributeO with null 
textAttribute 


Shall throw a NullPointerException 




4 


DstOffset >= dstBuffer.length 

SetMenuEntryTextAttribute { ) 
dstBuffer.length = 8 
dstOffset = 8 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




5 


dstOffset < 

SetMenuEntryTextAttribute { ) 
dstBuffer.length = 8 
dstOffset = -1 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




6 


DstLength > dstBuffer.length 

SetMenuEntryTextAttribute { ) 
dstBuffer.length = 3 
dstOffset = 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




7 


dstOffset + dstLength > dstBuffer.length 

SetMenuEntryTextAttribute { ) 
dstBuffer.length = 8 
dstOffset = 5 
dstLength = 4 


Shall throw a 
ArraylndexOutOfBoundsException 




8 


MENU_ENTRY_NOT_FOUND exception 

Call SetMenuEntryTextAttributeO with Id = 
08 


Shall throw a ToolkitException with 
MENU_ENTRY_NOT_FOUND 
reason code 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


BADJNPUT_PARAMETER exception 

Call setMenuEntryTextAttribute { ) with 
length = 2 


Shall throw a ToolkitException with 
BAD_INPUT_PARAMETER reason 
code 





5.2.9 Interface ViewHandler 

Tests are done in inheriting interfaces EnvelopeHandler, EnvelopeResponseHandler, ProactiveHandler and 
ProactiveResponseHandler. 

5.2.10 Interface BERTLVEditHandler 

5.2.10.1 Method setTag 

Test Area Reference: Api_2_Bte_Sttg. 

5.2.1 0.1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void setTag {byte bBERTag) 

5.2.1 0.1 .1 .1 Normal execution 

• CRRN 1 : Sets the tag of the BER TLV list. 



5.2.10.1.1.2 
No requirements. 

5.2.10.1.1.3 

No requirements. 

5.2.10.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.1.3 



Parameter errors 
Context errors 

Test area files 

Test_Api_2_Bte_Sttg.java. 
Api_2_Bte_Sttg_l .Java. 
api_2_bte_sttg .cap . 

Test coverage 



CRR number 


Test case number 


1 


1 



5.2.10.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 

buildTLVHandlerO with type BER_EDIT_HANDLER 
and capacity 0x10 






1 


1- setTag{0x01) 

2- getTagO 


2- Returns 0x01 





ETSI 



Release 6 



380 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.10.2 Method getTag 

Test Area Reference: Api_2_Bte_Gttg. 

5.2.10.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTag {) 

5.2.10.2.1.1 Normal execution 

• CRRNl : Returns the BER Tag of the BER TLV list. 



5.2.10.2.1.2 
No requirements. 

5.2.10.2.1.3 

No requirements. 

5.2.10.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.2.3 



Parameter errors 
Context errors 

Test area files 

Test_Api_2_Bte_Gttg.java. 
Api_2_Bte_Gttg_l .Java. 
api_2_bte_gttg. cap . 

Test coverage 



CRR number 


Test case number 


1 


Tested in API 2 BTE STTG 



5.2.10.3 Method getSize 

Test Area Reference: Api_2_Bte_Gtsz. 

5.2.10.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getSizeO 

5.2.10.3.1.1 Normal execution 

• CRRNl : Returns the BER TLV size, this includes the tag and the length. 

5.2.10.3.1.2 Parameter errors 
No requirements. 

5.2.10.3.1.3 Context errors 
No requirements. 
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5.2.10.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.3.3 



Test area files 

Test_Api_2_Bte_Gtsz.java. 
Api_2_Bte_Gtsz_l .Java. 
api_2_bte_gtsz.cap. 

Test coverage 



CRR number 


Test case number 


1 


1,2,3,4,5,6 



5.2.10.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 

buildTLVHandler with type BER_EDIT_HANDLER 
and capacity 0x110 






1 


Fill the handler with BERTLV tag 0x01, data 

length 0x2 2 

Call getSizeO method 


Returns 0x24 




2 


Fill the handler with BERTLV tag 0x01, data 

length 0x7F 

Call getSizeO method 


Returns 0x81 




3 


Fill the handler with BERTLV tag 0x01, data 

length 0x8 

Call getSizeO method 


Returns 0x83 




4 


Fill the handler with BERTLV tag 0x01, data 

length OxFF 

Call getSizeO method 


Returns 0x102 




5 


Fill the handler with BERTLV tag 0x01, data 

length 0x10 

Call getSizeO method 


Returns 0x104 




6 


Fill the handler with BERTLV tag 0x01, data 

length 0x110 

Call getSizeO method 


Returns 0x1 14 





5.2.10.4 Method getLength 

Test Area Reference Api_2_Bte_Glen. 

5.2.10.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength { ) 

throws ToolkitException 

5.2.1 0.4.1 .1 Normal execution 

• CRRNl : returns the length in bytes of the TLV Ust. 

5.2.10.4.1.2 Parameter errors 
No requirements. 

5.2.10.4.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 
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5.2.10.4.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.4.3 



Test area files 

Test_Api_2_Bte_Glen.j ava. 
Api_2_Bte_Glen_ 1 .j ava. 
api_2_bte_glen .c ap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER EDIT HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Clear the handler 

getLength { ) 


Result of getLengthO is 




2 


Call the appendArrayO method with buffer 
length 9 

getLength { ) 


Result of getLengthO is 9 




3 


Call the appendArrayO method, with buffer 
length = 253 

getLength { ) 


Result of getLengthO is 253 




4 


Build a 7Fh Handler and fill it with 
appendArrayO method 

getLength { ) 


Result of getLengthO is 7Fh 




5 


Build a 80h Handler and fill it with 
appendArrayO method 

getLength { ) 


Result of getLengthO is 80h 




6 


Build a lOOh Handler and fill it with 
appendArrayO method 

getLength { ) 


Result of getLengthO is lOOh 





5.2.10.5 Method copy 

Test Area Reference Api_2_Bte_Copy. 

5.2.10.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy{byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 
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5.2.10.5.1.1 Normal execution 

• CRRNl: copies the Comprehension TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

5.2.10.5.1.2 Parameter errors 

• CRRPl : if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the Comprehension TLV List, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 



5.2.10.5.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 



5.2.10.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.5.3 



Test area files 

Test_Api_2_Bte_Copy.j ava. 
Api_2_Bte_Copy _Ljava. 
api_2_bte_copy.cap. 

Test coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


CI 


Does not apply for BERTLVEdit 
Handler 



5.2.10.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER EDIT HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the appendArrayO method with 
81 03 01 41 42 82 02 81 43 








DstOffset > dstBuffer.length 

copy {) 

dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copy {) 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


DstLength > dstBuffer.length 

copy { ) 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

copy { ) 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copy { ) 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the Comprehension TLV 
list 

copy { ) 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

copy { ) 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

copy {) 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyQ is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

copy {) 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 





5.2.10.6 Method findTLV 

Test Area Reference Api_2_Bte_Find. 

5.2.10.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV{byte tag, byte occurrence) 
throws ToolkitException 

5.2.10.6.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes 
current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required 
flag is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined 
and TLV NOT FOUND is returned. 
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• CRRN5: The search method is comprehension required flag independent. 

5.2.10.6.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not vaHd (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.10.6.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.10.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.6.3 



Test area files 

Test_Api_2_Bte_Find.j ava. 
Api_2_Bte_Find_l .Java. 
api_2_bte_find.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








Invalid input parameter 

findTLVO 
Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER Is thrown 




2 


Call the initO method 








Search 1st TLV 

findTLVO 
Tag = Olh 
Occurrence = 1 


Result Is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

findTLVO 
Tag = 02h 
Occurrence = 1 


Result Is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result Is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

findTLVO 
Tag = 03h 
Occurrence = 1 


Result Is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitExceptlon.UNAVAILABLE 
ELEMENT Is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Search a tag with wrong occurrence 

findTLVO 
Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

findTLVO 
Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

findTLVO 
Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

findTLVO 
Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

findTLVO 
Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





5.2.10.7 Method getValueLength 

Test Area Reference Api_2_Bte_Gvle. 

5.2.10.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 



5.2.10.7.1.1 



Normal execution 



CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



5.2.10.7.1.2 
No requirements. 

5.2.10.7.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.10.7.2 Test area files 

Test Source: Test_Api_2_Bte_Gvle.java. 
Test Applet: Api_2_Bte_Gvle_l.java. 

Cap File: api_2_bte_gvle.cap. 
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5.2.10.7.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6 


C1 


Does not apply for BERTLVEdit Handler 


C2 


1 



5.2.10.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER EDIT HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








getValueLength { ) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Call the appendTLVO method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is OOh 




3 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 02 04 00 

length = 1 {+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 02h 




4 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D7F04 00 00... 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 7Fh 




5 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 81 80 04 00 00... 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is 80h 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D81 F1 04 00 00... 








Search TLV ODh (Text String TLV) 








getValueLength { ) 


Result is Flh 





5.2.10.8 Method getValueByte 

Test Area Reference Api_2_Bte_Gvby. 

5.2.10.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte {short valueOffset) 
throws ToolkitException 



5.2.10.8.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 

(1 byte). 
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5.2.10.8.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.10.8.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_2_Bte_Gvby.j ava. 
Api_2_Bte_Gvby_l .Java. 
api_2_bte_gvby.cap. 



5.2.10.8.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for BERTLVEdit Handler 


C2 


1 



5.2.10.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 FF FE 82 02 81 FD 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueByte(O) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




5 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D7F04 00 01 ... 7D 

Search TLV ODh {Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D81 80 04 00 01 ... 7E 

Search TLV ODh {Text String TLV) 








getValueByte(7E) 


Result is 7Dh 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


getValueByte(7F) 


Result is 7Eh 




8 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D81 F1 04 00 01 ... EF 

Search TLV ODh {Text String TLV) 
getValueByte{FO) 


Result is EFh 





5.2.10.9 Method copyValue 

Test Area Reference Api_2_Bte_Cpyv. 

5.2.10.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue {short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
Toolkit Except ion 

5.2.10.9.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

5.2.10.9.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 

5.2.1 0.9.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.10.9.2 Test area files 

Test Source: Test_Api_2_Bte_Cpyv.java. 
Test Applet: Api_2_Bte_Cpyv_Ljava. 

Cap File: api_2_bte_cpyv.cap. 
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5.2.10.9.3 



Test coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for BERTLVEdit Handler 


C2 


11 



5.2.10.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 

81 03 01 21 00 82 02 81 82 

Select a TLV 








copyValueO with a null dstBuffer 


NullPointerExceptlon is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 

Select Text String TLV 








dstOffset > dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

copyValue { ) 
dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 06 04 00 01 ...04 

Select Text String TLV 








valueOffset > Text String Length 

copyValue { ) 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
copyValue { ) 
valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


[Select Text String TLV] 

dstLength > Text String length 
copyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + dstLength > Text String 

length 

copyValue { ) 

valueOffset = 2 

dstBuffer. length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








copyValueQ 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown 




12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 

Select Text String TLV 








Successful call 

copyValue { ) 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

copyValue { ) 
valueOffset = 2 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





5.2.10.10 Method compareValue 

Test Area Reference Api_2_Bte_Cprv. 

5.2.10.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue {short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set , 
short compareLength) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 
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5.2.1 0.1 0.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in Comprehension TLV List is less than that in 
compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in Comprehension TLV List is greater than that in 
compareBuffer. 

5.2.10.10.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 



5.2.10.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.10.3 



Test area files 

Test_Api_2_Bte_Cprv.j ava. 
Api_2_Bte_Cprv_l .Java. 
api_2_bte_cprv.cap. 

Test coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for BERTLVEdit Handler 


C2 


11 



5.2.10.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 

81 03 01 21 00 82 02 81 02 

Select a TLV 








compareValueO with a null compareBuffer 


NullPointerException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareValue { ) 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 OD 06 04 00 01 ...04 
Select Text String TLV 








valueOffset > Text String Length 

compareValue { ) 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
compareValue { ) 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
compareValue { ) 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

compareValue { ) 

valueOffset = 2 

compareBuffer.length = 15 

compareOffset = 

compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








compareValueQ 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

compareValue { ) 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

compareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





ETSI 



Release 6 



395 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.1 0.1 1 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference Api_2_Bte_Facyb_Bs. 

5.2.1 0.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue {byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsExcept ion , 
ToolkitException 



5.2.10.11.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value 
into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of 
the copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

5.2.10.11.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



5.2.10.11.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException,HANDLER_NOT_AV AIL ABLE. 



5.2.10.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.11.3 



Test area files 

Test_Api_2_Bte_Facyb_Bs.java. 
Api_2_Bte_Facyb_Bs_l .Java. 
api_2_bte_f acyb_bs . cap . 

Test coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2,3,4,5 


C1 


Does not apply for BERTLVEdit Handler 
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5.2.10.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 02 








FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








dstOffset > dstBuffer.length 

f indAndCopyValue { ) 
tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


dstOffset < 

f indAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


length > dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

f indAndCopyValue { ) 
DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCopyValueQ 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call 

f indAndCopyValue { ) 
Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f indAndCopyValue { ) 
dstBuffer.length = 20 
dstOffset = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

buffer = 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








append a 2nd Text String TLV 








Successful call 

f indAndCopyValue { ) 
tag = ODh 

dstBuffer. length = 17 
dstOffset = 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




13 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue { ) 
tag = 8Dh 

dstBuffer. length = 17 
dstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCopyValue { ) 
tag = 8Fh 

dstBuffer. length = 16 
dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





5.2.1 0.1 2 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference Api_2_Bte_Facybbs_Bss. 

5.2.10.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



5.2.10.12.1.1 



Normal execution 



CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

CRRN2: if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

CRRN4: The search method is comprehension required flag independent. 
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5.2.10.12.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



5.2.10.12.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.10.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.12.3 



Test area files 

Test_Api_2_Bte_Facybbs_Bss.java. 

Api_2_Bte_Facybbs_Bss_Ljava. 

api_2_bte_facybbs_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21,22,23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


24 


CI 


Does not apply for BERTLVEdit Handler 



5.2.10.12.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








dstOffset > dstBuffer.length 

f indAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer.length = 5 

dstOffset = 6 

dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


dstOffset < 

f IndAndCopyValue { ) 
dstBuffer. length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer. length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




5 


dstOffset + dstLength >dstBuffer.length 

f IndAndCopyValue { ) 
dstBuffer. length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


dstLength < 

f IndAndCopyValue { ) 
dstBuffer. length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 06 04 00 01 ...04 








valueOffset > Text String Length 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 7 

dstBuffer. length = 15 

dstOffset = 

dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCopyValue { ) 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

f IndAndCopyValue { ) 
valueOffset = 2 
dstBuffer. length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCopyValueQ 

f IndAndCopyValue { ) 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO is 
17 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 2 

dstBuffer. length = 20 

dstOffset = 3 

dstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOli 




16 


Append a Text String TLV 

f IndAndCopyValue { ) 

tag = OD 

buffer = 00 11 22 33 44 55 {no specific 

DCS byte) 








Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 1 

valueOffset = 

dstBuffer. length = 17 

dstOffset = 

dstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOfi 




18 


Successful call 

f IndAndCopyValue { ) 

tag = ODh, occurrence = 2 

valueOffset = 

dstBuffer. length = 6 

dstOffset = 

dstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOli 




20 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Successful call (with tag 8Dh) 

f IndAndCopyValue { ) 
tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOli 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCopyValue { ) 
tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer. length = 16 
dstOffset = 
dstLength = 16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOli 




24 


Invalid parameter 

f IndAndCopyValue { ) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 
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5.2.10.13 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference Api_2_Bte_Facrb_Bs. 

5.2.10.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue {byte tag, 

byte [] compareBuffer, 
short compareOffset) 
throws Java . lang.NullPointerException, 

Java. lang.ArraylndexOutOfBoundsException, 
ToolkitException 

5.2.1 0.1 3.1 .1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer returns -L 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.10.13.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall 
be thrown. 

5.2.10.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

5.2.10.13.2 Test area files 

Test Source: Test_Api_2_Bte_Facrb_Bs.java. 
Test Applet: Api_2_Bte_Facrb_Bs_Ljava. 

Cap File: api_2_bte_facrb_bs.cap. 
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5.2.10.13.3 



Test coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.13.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandlerO with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = ODh 

compareBuffer.length =20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f indAndCompareValue { ) 
compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

f IndAndCompareValue { ) 
compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

f IndAndCompareValue { ) 
compareBuf f er . length 
compareBuffer.length =20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

compareBuf fer = 
04 00 01 ... OF 








Compare buffers 

f indAndCompareValue { ) 
tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength { ) 


Result is 17 





£75/ 



Release 6 



403 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


9 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f indAndCompareValue { ) 
compareOf f set = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

f IndAndCompareValue { ) 
compareOf f set = 2 


Result is +1 




15 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f IndAndCompareValue { ) 
tag = 8Dh 

compareBuf fer. length = 17 
compareOf f set = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f IndAndCompareValue { ) 
tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Initialize compareBuffer 

compareBuf fer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

f indAndCompareValue { ) 
tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is +1 





5.2.1 0.1 4 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference Api_2_Bte_Facrbbs_Bss. 

5.2.10.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f IndAndCompareValue {byte tag, 

byte occurrence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
compareLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

5.2.10.14.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in Comprehension TLV is less than that in compareBuffer -1 is 
returned. 

• CRRN5: if the first miscomparing byte in Comprehension TLV is greater than that in compareBuffer 1 is 
returned. 

• CRRN6: The search method is comprehension required flag independent. 

5.2.10.14.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset is negative or valueOffset + dstLength > current TLV length, an instance of 
ToolkitException shall be thrown. The reason code shall be 
ToolkitException.OUT_OF_TLV_BOUNDARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException.BAD_INPUT_PARAMETER. 



ETSI 



Release 6 



405 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.2.10.14.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



5.2.10.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.14.3 



Test area files 

Test_Api_2_Bte_Facrbbs_Bss.java. 
Api_2_Bte_Facrbbs_Bss_l .Java. 
api_2_bte_facrbbs_bss.cap. 

Test coverage 



GRR number 


Test case number 


NI 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16, 19 


N6 


23,24 


PI 


1 


P2 


2, 3, 4, 5, 6 


PS 


7,8,9, 10 


P4 


11 


CI 


Does not apply for BERTLVEdit Handler 



5.2.10.14.4 



Test procedure 



id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER EDIT HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Initialize the handler with 
81 03 01 21 00 82 02 81 82 








findAndCompareValueQ with a null 
compareBuffer 


NullPointerException is thrown 




2 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 10 04 00 01 ... OE 








compareOffset > compareBuffer.length 

f indAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

f indAndCompareValue { ) 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


compareLength < 

f IndAndCompareValue { ) 
compareBuffer. length = 5 
compareOf f set = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 OD 06 04 00 01 ...04 








valueOffset > Text String Length 

f IndAndCompareValue { ) 
tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

f IndAndCompareValue { ) 
valueOffset = -1 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

f IndAndCompareValue { ) 
valueOffset = 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

f IndAndCompareValue { ) 
valueOffset = 2 
compareBuffer. length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

f IndAndCompareValue { ) 
occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




12 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE 
ELEIVIENT is thrown. 




13 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

getValueLength { ) 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 

04 00 01 02 03 04 05 06 07 08 09 OA OB OC 

OD OE 10 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

f IndAndCompareValue { ) 
valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 

55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


23 


Initialize the handler with 81 03 01 21 00 82 02 
81 02 0D11 04 00 01 ...OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

f in<iAn<aCompareValue { ) 
tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuffer. length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

f in<iAn<aCompareValue { ) 
tag = BFh, occurrence = 1 
valueOffset = 
compareBuffer. length = 16 
compareOf f set = 
compareLength = 16 


Result is OOh 




25 


Initialize compareBuffer 

compareBuffer =0099 02 ... OF 

findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 





5.2.10.15 Method getCapacity 

Test Area Reference: Api_2_Bte_Gcap. 

5.2.10.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getCapacity { ) 

5.2.10.15.1.1 Normal execution 

• CRRNl: The method shall return the maximum size of the Comprehension TLV list managed by the handler. 



5.2.10.15.1.2 
No requirements 

5.2.10.15.1.3 
No requirements 

5.2.10.15.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Bte_Gcap.java. 

Api_2_Bte_Gcap_l.java. 

api_2_bte_gcap.cap. 
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5.2.10.15.3 



Test coverage 



CRR number 


Test case number 


N1 


1 



5.2.10.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 

BER EDIT HANDLER and capacity 0x10 and set 
its BER Tag to 0x01 






1 


1- The applet calls getCapacity { ) on the 
BERTLVEditHandler 

2- The applet fills the handler with the 
maximum capacity, using appendTLVO method 

3- The applet calls clear {) on the 
BERTLVEdit handler 

4- The applet fills the handler with the 
maximum capacity plus one, using 
appendTLVO method 


1- No exception is tlirown, the 
capacity shall be 0x10 

2- No exception is thrown 

3- No exception is thrown 

4- HANDLER_OVERFLOW 
exception is thrown 





5.2.1 0.1 6 Method getValueShort 

Test Area Reference: Api_2_Bte_Gvsh. 

5.2.10.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueShort {short valueOffset) 
throws ToolkitException 



5.2.10.16.1.1 



Normal execution 



• CRRNl: Gets a short from the last TLV element which has been found in the handler and returns its value 
(1 short). 



5.2.10.16.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.OUT_OF_TLV_BOUND ARIES. 



5.2.10.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException.UNAVAILABLE_ELEMENT. 

5.2.10.16.2 Test area files 

Specific triggering: None. 

Test Source: Test_Api_2_Bte_Gvsh.java. 
Test Applet: Api_2_Bte_Gvsh_Ljava. 

Cap File: api_2_bte_gvsh.cap. 
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5.2.10.16.3 



Test coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for BERTLVEdit Handler 


C2 


1 



5.2.10.16.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandlerO with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Initialize the handler 
with 81 03 01 FF FE 82 02 81 FD 








getValueShort(O) 


ToolkitException.UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueShort(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueShort(l) 


Result is FFh Feh (type, qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueShort(O) 


Result is 81 h FDh (Source, 
Destination) 




5 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 0D7F04 00 01 ... 7D 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




6 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 0D81 80 04 00 01 ... 7E 

Search TLV ODh (Text String TLV) 








getValueShort(7D) 


Result is 7Ch 7Dh 




7 


getValueShort(7E) 


Result is 7Dh 7Eh 




8 


Initialize the handler with 81 03 01 21 00 82 02 

81 02 0D81 F1 04 00 01 ... EF 

Search TLV ODh (Text String TLV) 








getValueShort(EF) 


Result is Eeh Efh 





5.2.10.17 Method appendArray 

Test Area Reference: Api_2_Bte_Apda. 

5.2.10.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

Public void appendArray {byte [] buffer, 

short offset, 
short length) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.1 0.1 7.1 .1 Normal execution 

• CRRNl: appends a buffer into the Edithandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 
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5.2.10.17.1.2 Parameter errors 

• CRRPl: if buffer is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.10.17.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.10.17.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.17.3 



Test area files 

Test_Api_2_Bte_Apda.j ava. 
Api_2_Bte_Apda _l.java. 
api_2_bte_apda.cap. 

Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


PI 


1 


P2 


2,3,4,5,6 


CI 


7 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.17.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null buffer 

appendArray { ) 


NullPointerException is thrown 




2 


offset > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


Offset < 

appendArray { ) 
buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

appendArray { ) 
buffer.length = 5 

offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


Offset + length > buffer.length 

appendArray { ) 
buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

appendArray { ) 
buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER EDIT HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






7 


Handler overflow exception 

appendArray { ) 

buffer. length = getCapacity { ) +1 

offset = 

length = getCapacity {) +1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Successful call 

appendArray { ) 
buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03li 




9 


Clear the handler 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 


Result of 

javacard.frameworl<.Util.arrayCom 
pare{) is OOh 




10 


Successful call 

appendArray { ) 
buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




11 


Successful call 

appendArray { ) 
buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




12 


Clear the handler 








Successful call 

appendArray { ) 
buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





5.2.1 0.1 8 Method appendTLV(byte tag, byte value) 

Test Area Reference: Api_2_Bte_Aptlbb. 

5.2.10.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, byte value) 
throws ToolkitException 
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5.2.1 0.1 8.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.18.1.2 Parameter errors 
No requirements. 

5.2.10.18.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



5.2.10.18.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.18.3 



Test area files 

Test_Api_2_Bte_Aptlbb.java. 
Api_2_Bte_Aptlbb_l .Java. 
api_2_bte_aptlbb.cap. 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


CI 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.18.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendlLVQ method 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVQ method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 01 00 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

appendTLV { ) 
tag = Olh 
value = FEh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




5 


Clear the handler 
Call appendArrayO 

length = 25 

buffer = 00 81 F7 03 04 ... F9 

Successful call 

appendTLV { ) 
tag = 84h 
value = OOh 

Call getLengthO method 
Call copyO method 
Compare the array 

compareBuffer = 00 81 F7 03 04 ... F9 84 01 
00 


result = 253 

Result of 

javacard.framework.Utll.arrayCom 
pare{) is OOh 





5.2.1 0.1 9 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: Api_2_Bte_Aptlbbb. 

5.2.10.19.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte value) 
throws ToolkitException 

5.2.1 0.1 9.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.19.1.2 Parameter errors 
No requirements. 

5.2.10.19.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 
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5.2.10.19.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.19.3 



Test area files 

Test_Api_2_Bte_Aptlbbb.java. 
Api_2_Bte_Aptlbbb_l .Java. 
api_2_bte_aptlbbb . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.19.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Call the appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 
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5.2.1 0.20 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: Api_2_Bte_Aptlb_Bss. 

5.2.10.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV{byte tag, 

byte [] value, 
short valueoffset, 
short valuelength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.1 0.20.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.1 0.20.1 .2 Parameter errors 

• CRRPl: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.10.20.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.10.20.2 Test area files 

Test Source: Test_Api_2_Bte_Aptlb_Bss.java. 
Test Applet: Api_2_Bte_Aptlb_Bss_l.java. 

Cap File: api_2_bte_aptlb_bss.cap. 

5.2.1 0.20.3 Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for BERTLVEdit Handler 


C3 


8 
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5.2.10.20.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null value 

appendTLV { ) 


NullPointerException is thrown 




2 


valueOffset > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


valueOffset < 

appendTLV { ) 
value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


valueLength > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

appendTLV { ) 
value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

appendTLV { ) 
value . length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow exception 

Call the appendArray { ) method, length = 

getCapacity {) -1 

appendTLV { ) 

value.length = 254 

valueOffset = 

valueLength = 254 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLV { ) 
value.length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD_INPUT_PA 

RAIVIETER is thrown 




9 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Successful call 

appendTLV { ) 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

value = FF FE ... F8 

valueOffset = 

valueLength = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





ETSI 



Release 6 



418 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call 

appendTLV { ) 

tag = 85h 

value = 00 01 ... 07 

valueOffset = 2 

valueLength = 6 








Call copyQ method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




12 


Successful call 

appendTLV { ) 

tag = 01 

value = 11 22 ... 88 

valueOffset = 2 

valueLength = 4 








Call copvO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Utll.arrayCom 
pareO is OOh 




13 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

value = 00 01 ... 7F 

valueOffset = 

valueLength = 80h 








Call copyQ method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




14 


Clear the handler 

Successful call 

appendTLV { ) 

tag = 04 

value = 00 01 ... F9 

valueOffset = 

valueLength = 250 

Call getLengthO method 

Call copyO method 
Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


result = 253 

Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 





5.2.1 0.21 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: Api_2_Bte_Aptlbb_Bss. 

5.2.1 0.21 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte valuel 
byte [] value2 , 
short value2of f set , 
short value21ength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 
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5.2.1 0.21 .1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.21.1.2 Parameter errors 

• CRRPl: if value2 is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



5.2.10.21.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

5.2.10.21.2 Test area files 

Test Source: Test_Api_2_Bte_Aptlbb_Bss.java. 
Test Applet: Api_2_Bte_Aptlbb_Bss_l.java. 

Cap File: api_2_bte_aptlbb_bss.cap. 



5.2.10.21.3 



Test coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


PI 


1 


P2 


2,3,4,5,6 


CI 


7 


C2 


Does not apply for BERTLVEdit Handler 


C3 


8 



5.2.10.21.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandlerO with type 
BER EDIT HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null value2 

appendTLV { ) 


NullPointerException is thrown 




2 


value20ffset > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

appendTLV { ) 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


value2Length > value2. length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

appendTLV { ) 
value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


value2Length < 

appendTLV { ) 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




7 


Handler overflow exception 

Call the appendArray { ) method, length = 

getCapacity {) -1 

appendTLV { ) 

value2 . length = 254 

value20ffset = 

value2Length = 254 


Tooll<itException.HANDLER OVE 
RFLOW is thrown 




8 


Bad parameter exception 

Clear the handler 
appendTLV { ) 
value2 . length = 256 
value20ffset = 
value2Length = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Successful call 

appendTLV { ) 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 

appendTLV { ) 

tag = 04 

valuel = 05 

value2 = FF FE ... F8 

value20ffset = 

value2Length = 8 








Call copyQ method 








Compare the arrays 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result of 

javacard.frameworl<.Util.arrayCom 
pare{) is OOh 




11 


Successful call 

appendTLV { ) 
tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyQ method 








Compare the arrays 

CompareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.frameworl<.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Successful call 

appendTLV { ) 
tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyQ method 








Compare the arrays 

CompareBuf f er = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 SS 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copvO method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




14 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 04 
valuel =00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copyQ method 








Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


Result of 

javacard.frameworl<.Util.arrayCom 
pare{) is OOh 





5.2.1 0.22 Method appendTLV(byte tag, byte valuel , short value2) 

Test Area Reference: Api_2_Bte_Aptlbbs. 

5.2.10.22.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte valuel, 
short value2) 
throws ToolkitException 

5.2.1 0.22.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (3-byte element(l -byte, 1 -short)). 

• CRRN2: A successful append does not modify the TLV selected. 



5.2.10.22.1.2 
No requirements 



Parameter errors 
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5.2.10.22.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.10.22.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Bte_Aptlbbs.java. 
Test Applet: Api_2_Bte_Aptlbbs_l.java. 

Cap File: api_2_bte_aptlbbs.cap. 



5.2.10.22.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


CI 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.22.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Call the appendArrayO 
length = getCapacity()-1 








Handler Overflow exception: 
Call the appendTLVQ method 


ToolkitException.HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 

value2 = 01h02h 








Call copyO method 








Compare the arrays 
compareBuffer = 84 03 00 01 02 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh 
value2 = FDh FCh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 03 00 01 02 01 03 FE FD 

FC 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Clear the handler 








Call appendArrayO 

length = 248 

buffer = 00 81 F5 03 04 ... F7 








Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh 
value2 = Olh 02h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F5 03 04 ... F7 84 03 00 

01 02 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 





5.2.1 0.23 Method appendTLV(byte tag, short value) 

Test Area Reference: Api_2_Bte_Aptlbs. 

5.2.10.23.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

short value) 
throws ToolkitException 

5.2.1 0.23.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte or 1-short element). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.1 0.23.1 .2 Parameter errors 
No requirements 

5.2.10.23.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.10.23.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Bte_Aptlbs.java. 
Test Applet: Api_2_Bte_Aptlbs_l.java. 

Cap File: api_2_bte_aptlbs.cap. 



5.2.10.23.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for BERTLVEdit Handler 
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5.2.10.23.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 

buildTLVHandlerO with type BER_EDIT_HANDLER 
and capacity 0x100 and set its BER Tag to 
0x01 






1 


Call appendArrayO 

length = getCapacity { ) -1 








Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException. HANDLER 
VERFLOW is thrown 




2 


Initialize handler with 
81 03 01 00 00 82 02 81 00 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03li 




3 


Clear the handler 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh Olh 








Call copyO method 








Compare the arrays 
compareBuffer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayC 
ompareO is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
value = FEh FFh 








Call copyO method 








Compare the arrays 
compareBuffer = 84 02 00 01 01 02 FE FF 


Result of 

javacard.framework.Util.arrayC 
ompareO is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04... F8 








Successful call 

appendTLV { ) 
tag = 84h 
value = OOh Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare the array 
compareBuffer = 00 81 F6 03 04 ... F8 84 02 00 01 


Result of 

javacard.framework.Util.arrayC 
ompareO is OOh 





5.2.1 0.24 Method appendTLV(byte tag, short valuel , short value2) 

Test Area Reference: Api_2_Bte_Aptlbss. 

5.2.10.24.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

short valuel, 
short value2) 
throws ToolkitException 

5.2.10.24.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (4-byte element(2-short)). 

• CRRN2: A successful append does not modify the TLV selected. 
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5.2.10.24.1.2 
No requirements 

5.2.10.24.1.3 



Parameter errors 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

5.2.10.24.2 Test area files 

Specific triggering: Unrecognized Envelope: 

Test Source: Test_Api_2_Bte_Aptlbss.java. 
Test Applet: Api_2_Bte_Aptlbss_l.java. 

Cap File: api_2_bte_aptlbss.cap. 



5.2.10.24.3 



Test coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


CI 


1 


C2 


Does not apply for BERTLVEdit Handler 



5.2.10.24.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 0x10 and 
set its BER Tag to 0x01 






1 


Call the appendArrayO 

length = getCapacity { ) -1 

Handler Overflow exception: 
Call the appendTLVO method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler with 

81 03 01 00 00 82 02 81 00 

Select Command Details TLV 

Call the appendTLVO method 

Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 
Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 

Call copyO method 

Compare the arrays 

compareBuffer = 84 04 00 01 02 03 


Result of 

javacard.framework.Util.arrayCom 
pare{) is OOh 




4 


Successful call 

appendTLV { ) 
tag = Olh 
valuel = FEh FDh 
value2 = FCh FBh 

Call copyO method 

Compare the arrays 

compareBuffer = 84 04 00 01 02 03 01 04 FE FD 

FCFB 


Result of 

javacard.framework.Utii.arrayCom 
pareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Clear the handler 
Call append ArrayO 

length = 247 

buffer = 00 81 F4 03 04 ... F6 

Successful call 

appendTLV { ) 
tag = 84h 
valuel = OOh Olh 
value2 = 02h 03h 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 


Result of 






compareBuffer = 00 81 F4 03 04 ... F6 84 04 00 


javacard.framework.Utll.arrayCom 






01 02 03 


pare{) is OOh 





5.2.1 0.25 Method appendTLV(byte tag, byte[] valuel , short valuel Offset, short 
valuel Length, byte[] value2, short value20ffset, short value2Length) 

Test Area Reference: Api_2_Bte_Aptlb_Bss_Bss. 

5.2.10.25.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public void appendTLV {byte tag, 

byte [] valuel, 
short valuelOf f set , 
short valuelLength, 
byte [] value2 , 
short value20f f set , 
short value2Length) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

5.2.10.25.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2 byte arrays format). 

• CRRN2: A successful append does not modify the TLV selected. 

5.2.10.25.1.2 Parameter errors 
No requirements. 

5.2.10.25.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: If valuelLength or value2Length is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

• CRRC4: If valuel or value2 is null, a NullPointerException is thrown. 

• CRRC5: If valuel Offset or valuelLength or both would cause access outside valuel array bounds, or if 
valuelLength is negative, an ArraylndexOutOfBoundsException is thrown. 

• CRRC6: If value20ffset or value2Length or both would cause access outside value2 array bounds, or if 
value2Length is negative, an ArraylndexOutOfBoundsException is thrown. 
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5.2.10.25.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.25.3 



Test area files 

Test_Api_2_Bte_Aptlb_Bss_Bss.java. 
Api_2_Bte_Aptlb_Bss_Bss_l .Java. 
api_2_bte_aptlb_bss_bss.cap. 

Test coverage 



CRR number 


Test case number 


N1 


18, 19,20,21 


N2 


17 


P1 


1,2 


P2 


3, 4, 5, 6, 7 


P3 


8, 9, 10, 11, 12 


C1 


13 


C2 


Does not apply for BERTLVEdit Handler 


C3 


14, 15 



5.2.10.25.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER EDIT HANDLER and capacity 0x100 and 
set its BER Tag to 0x01 






1 


Null valuel 

appendTLV { ) 


NullPointerException is thrown 




2 


Null value2 

appendTLV { ) 


NullPointerException is thrown 




3 


ValuelOffset > valuel. length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 5 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


ValuelOffset <0 

appendTLV { ) 
valuel . length = 5 
valuelOffset = -1 
valuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValuelLength > valuel. length 

appendTLV { ) 
valuel . length = 5 
valuelOffset = 
valuelLength = 6 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


ValuelOffset + valuelLength > valuel. length 

appendTLV { ) 
Valuel . length = 5 
valuelOffset = 3 
valuelLength = 3 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Valuel LengtiK 

appendTLV { ) 
valuel . length = 5 
ValuelOffset = 
ValuelLength = -1 
value2 . length = 5 
value20ffset = 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




8 


Value20ffset > value2.length 

appendTLV { ) 
valuel . length = 5 
ValuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 5 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




9 


Value20ffset < 

appendTLV { ) 
valuel . length = 5 
ValuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




10 


Value2Length > value2.length 

appendTLV { ) 
valuel . length = 5 
ValuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




11 


Value20ffset + value2Length > value2.length 

appendTLV { ) 
valuel . length = 5 
ValuelOffset = 
ValuelLength = 1 
Value2 . length = 5 
Value20ffset = 3 
Value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




12 


Value2Length < 

appendTLV { ) 
valuel . length = 5 
ValuelOffset = 
ValuelLength = 1 
value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




13 


Handler overflow exception 

Call the appendArray { ) method, length = 

getCapacity { ) -1 

appendTLV { ) 

Valuel . length = 256 

ValuelOffset = 

ValuelLength = 253 

Value2 . length = 256 

Value20ffset = 

Value2Length = 1 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




14 


Bad parameter exception 

Clear the handler 
appendTLV { ) 
Valuel. length = 256 
ValuelOffset = 
ValuelLength = 256 
Value2 . length = 256 
Value20ffset = 
Value2Length = 1 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




15 


Bad parameter exception 

appendTLV { ) 
Valuel . length = 256 
ValuelOffset = 
ValuelLength = 1 
Value2 . length = 256 
Value20ffset = 
Value2Length = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 






17 


Successful call 

appendTLV { ) 
tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
valuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Verify Current TLV: Call getValueLengthQ 
Clear the handler 


Result is 03h 




18 


Successful call 

appendTLV { ) 
tag = 04 

valuel = FF FE ... F8 
valuelOffset = 
valuelLength = 8 
value2 = F7 F6 ... FO 
value20ffset = 
value2Length = 8 

Call copyO method 

Compare handler 

CompareBuffer = 04 10 FF FE ... FO 


Result is 00 




19 


Successful call 

appendTLV { ) 
tag = 85h 

valuel = 00 01 ... 07 
valuelOffset = 2 
valuelLength = 6 
value2 = 08 09 ... OF 
value20ffset = 2 
value2Length = 6 

Call copyO method 

Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 


Result is 00 




20 


Successful call 

appendTLV { ) 
tag = 01 

valuel = 11 22 ... 88 
valuelOffset = 2 
valuelLength = 4 
value2 = 99 AA ... FF 00 
value20ffset = 2 
value2Length = 4 

Call copyO method 

Compare handler 

compareBuffer = 04 10 FF FE ... FO 85 OC 02 03 

04 05 06 07 OA OB OC OD OE OF 01 08 33 44 55 

66 BB CC DD EE 

Clear the handler 


Result is 00 




21 


Successful call 

appendTLV { ) 
tag = 04 

valuel = 00 01 ... 7F 
valuelOffset = 
valuelLength = 8 Oh 
value2 = 80 81 ... FC 
value20ffset = 
value2Length = 7Dh 

Call copyO method 

Compare handler 

compareBuffer = 04 81 FD 00 01 ...FC 


Result is 00 
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5.2.10.26 Method clear 

Test Area Reference: Api_2_Bte_Cler. 

5.2.10.26.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void clear {) 

throws ToolkitException 

5.2.1 0.26.1 .1 Normal execution 

• CRRN 1 : Clears the TLV list of an EditHandler. 

• CRRN2: Resets the current TLV selected. 



5.2.10.26.1.2 
No requirements. 

5.2.10.26.1.3 



Parameter errors 



Context errors 



CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



5.2.10.26.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.10.26.3 



Test area files 

Test_Api_2_Bte_Cler.j ava. 
Api_2_Bte_Cler_l .Java. 
api_2_bte_cler.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


C1 


Does not apply for BERTLVEdit Handler 



5.2.10.26.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get a BERTLVEditHandler using 
buildTLVHandler {) with type 
BER_EDIT_HANDLER and capacity 
0x100 and set its BER Tag to 
0x01 






1 


Initialize the handler with 
81 03 01 00 00 82 02 81 00 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthO 
method 


ToolkitException. UNAVAILABLE_ELEMENT 
is thrown 
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5.2.11 Interface BERTLVViewHandler 

Tests are done in inheriting interfaces BERTLVEditHandler and envelopeHandler. 

5.2.12 Class EnvelopeHandlerSystem 
5.2.12.1 Method getTheHandler 

Test Area Reference: Api_2_Ehs_Gthd. 

5.2.12.1.1 Conformance requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler { ) 

throws ToolkitException 



5.2.12.1.1.1 



Normal execution 



CRRNl: The method shall return the single system instance of the class implementing the EnvelopeHandler 
interface. 

CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [2]). 



5.2.12.1.1.2 
No requirements. 

5.2.12.1.1.3 



Parameter errors 



Context errors 



• CRRC 1 : The method shall thrown ToolkitException.H ANDLER_NOT_AV AILABLE if the handler is not 
available. 



5.2.12.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.12.1.3 



Test area files 

Test_Api_2_Ehs_Gthd.j ava. 
Api_2_Ehs_Gthd_ 1 .j ava. 
api_2_ehs_gthd.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 1 and 2) 


C1 


checl<ed in CAT Runtime Environment: Cre_IVIIia_Enhd (Test case 1) 



5.2.12.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call GetTheHandler {) method twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler { ) method returns 
an EnvelopeHandler . getTheHandler { ) 


The reference returned shall be an 

object implementing the 

EnvelopeHandler interface (check 

cast) 




3 


Verify the returned value is not null 


The reference returned shall not be 
null. 
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5.2.13 Class EnvelopeResponseHandlerSystem 
5.2.13.1 Method getTheHandler 

Test Area Reference: Api_2_Ers_Gthd. 

5.2.13.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeResponseHandler getTheHandler { ) 

throws ToolkitException 



5.2.13.1.1.1 



Normal execution 



• CRRNl: The method shall return the single system instance of the class implementing the 
EnvelopeResponseHandler interface. 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [2]). 



5.2.13.1.1.1 
No requirements. 

5.2.13.1.1.3 



Parameter errors 



Context errors 



CRRCl: The method shall thrown ToolkitException.HANDLER_NOT_AVAILABLE if the handler is not 
available. 

CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no 
more available. 



5.2.13.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.13.1.3 



Test area files 

Test_Api_2_Ers_Gthd.j ava. 
Api_2_Ers_Gthd_ 1 .j ava. 
api_2_ers_gthd.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 3 and 4) 


C1 


cliecl<ed in CAT Runtime Environment: Cre IVIha Erlid (Test case 1) 


C2 


4 



5.2.13.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call getTheHandlerO twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeResponseHandler 

Call getTheHandlerO method 


The reference returned shall be an 
object implementing the 
EnvelopeResponseHandler 
interface (check cast) 




3 


Verify the returned value is not null 

Call getTheHandlerO method 


The reference returned shall not be 
null. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Send a proactive command, and then, Call 
getTheHandlerO 


ToolkitException. HANDLER NOT 
AVAILABLE is thrown 





5.2.14 Class ProactiveHandlerSystem 
5.2.14.1 Method getTheHandler 

Test Area Reference: Api_2_Phs_Gthd. 

5.2.14.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandlerO 

throws ToolkitException 



5.2.14.1.1.1 



Normal execution 



• CRRNl: The method shall return the single system instance of the class implementing the ProactiveHandler 
interface. 

• CRRN2: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [2]). 

5.2.14.1.1.2 Parameter errors 
No requirements. 

5.2.14.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 

5.2.14.1.2 Test area files 

Test_Api_2_Phs_Gthd.j ava. 

Api_2_Phs_Gthd_l.java. 

api_2_phs_gthd.cap. 

Test coverage 



Test Source: 
Test Applet: 
Cap File: 

5.2.14.1.3 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


checl<ed in CAT Runtime Environment: Cre Api Hepo (Test case 5 and 6) 


C1 


checl<ed in CAT Runtime Environment: Cre IVIlia Pahd (Test case 1) 



5.2.14.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call getTheHandlerO method twice 


The returned objects shall be the 
same 




2 


Call getTheHandlerO method 


The reference shall be an objetc 
implementing the 
ProactiveHandler interface 




3 


Call getTheHandlerO method 


The reference shall not be null 
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5.2.15 Class ProactiveResponseHandlerSystem 
5.2.15.1 Method getTheHandler 

Test Area Reference: Api_2_Prs_Gthd. 

5.2.1 5.1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler { ) 

throws ToolkitException 



5.2.15.1.1.1 



Normal execution 



• CRRNl: The method shall return the single system instance of the object implementing the ProactiveHandler 
interface. 

• CRRN2: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [2]). 

5.2.15.1.1.2 Parameter errors 
No requirements. 

5.2.15.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AV AILABLE if the handler is busy. 

5.2.13.1.2 Test area files 

Test_Api_2_Prs_Gthd.j ava. 
Api_2_Prs_Gthd_l .Java. 
api_2_prs_gthd.cap. 

Test coverage 



Test Source: 
Test Applet: 
Cap File: 

5.2.15.1.3 



CRR number 


Test case number 


N1 


1,2,3 


N2 


checked in CAT Runtime Environment: Cre Api Hepo (Test case 7 and 8) 


C1 


cliecl<ed in CAT Runtime Environment: Cre IVIha Prlid (Test case 1) 



5.2.15.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








Call getTheHandlerO twice method 


The returned objects shall be the 
same 




2 


Call getTheHandlerO method 


The reference shall be an object 
implementing the 
ProactiveResponseHandler 
interface 




3 


Call getTheHandlerO method 


The reference shall not be null 
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5.2.1 6 Class TerminalProfile 

5.2.1 6.1 Method check(byte index) 

Test Area Reference: Api_2_Tep_Checb. 

5.2.1 6.1 .1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check {byte index) 

throws ToolkitException 

5.2.1 6.1 .1 .1 Normal execution 

• CRRNl: The method checks a facility in the handset profile: returns true if supported and false otherwise. 

• CRRN2: returns false if facility-index is outside Terminal Profile data. 

5.2.16.1.1.2 Parameter errors 

• CRRP 1 : shall throw B AD_INPUT_PARAMETER ToolkitException if index has a negative value. 

5.2.16.1.1.3 Context errors 

• CRRC 1 : shall throw TERMIN AL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal Profile data 
are not available. 

5.2.16.1.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND: 
Test Source: Test_Api_2_Tep_Checb.java. 
Test Applet: Api_2_Tep_Checb_l.java. 

Cap File: api_2_tep_checb.cap. 



5.2.16.1.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


4 


P1 


5 


C1 


1 



5.2.16.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

1- Trigger applet with status command 

2- Call check method with Index = 1 


1 - applet is triggered 
2- 

TERMINAL_PROFILE_NOT_AVAI 
LABLE Tooll<itException is thrown 




2 


Terminal Profile, Facility is supported 

1- Trigger applet with 
EVENT_UNRECOGNIZED_ENVELOPE 

2- Call check {) method with 
index = 


1- applet is triggered 

2- returns true 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Facility is not supported 

Call check {) method with index = 15 


returns false 




4 


Facility index is outside TerminalProfile data 

Call check {) method with index = Ox7F 


Returns false 




5 


Index has a negative value 

Call check { ) method with index = -1 


Throws a ToolkitException with 
BAD_INPUT_PARAMETER reason 
code. 





5.2.1 6.2 Method check(byte [] mask, short offset, short length) 

Test Area Reference: Api_2_Tep_Chec_Bss. 

5.2.16.2.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check {byte [] mask, 

short offset, 
short length) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
ToolkitException 



5.2.16.2.1.1 



Normal execution 



• CRRNl: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if 
the bitwise AND of the TerminalProfile data padded with and the mask is equal to the mask , false 
otherwise. 

• CRRN2: The method returns true if the length is equal to 0. 

5.2.16.2.1.2 Parameter errors 

• CRRPl: The method shall throw java.lang.NullPointerException if mask is null. 

• CRRP2: The method shall throw Java. lang. ArraylndexOutOfBoundsException if check would cause access of 
data outside mask array bounds. 

• CRRP3: If offset or length parameter is negative an ArraylndexOutOfBoundsException exception is thrown 
and no check is performed. 

• CRRP4: If offset+length is greater than mask.length, the length of the mask array an 
ArraylndexOutOfBoundsException exception is thrown and no check is performed. 



5.2.16.2.1.3 



Context errors 



• CRRC 1 : The method shall throw TERMINAL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal 
Profile data are not available. 

5.2.16.2.2 Test area files 

Specific triggering: MENU_SELECTION: 

Test Source: Test_Api_2_Tep_Chec_Bss.java. 
Test Applet: Api_2_Tep_Chec_Bss_l.java. 

Cap File: api_2_tep_chec_bss.cap. 
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5.2.16.2.3 



Test coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


P1 


2 


P2 


3, 4, 5, 6 


P3 


4,7 


P4 


6 


C1 


1 



5.2.16.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by Menu Selection 

Call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 16 


TERMINAL_PROFILE_NOT_A 
VAILABLE ToolkitException is 
thrown 




2 


NULL as parameter to check 

Call check {) method: 
mask= NULL 


NullPointerException is thrown 




3 


Offset > mask.length 

Call check { ) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 17 


Array 1 ndexOutOfBou ndsExcep 
tion is thrown 




4 


Offset < 

Call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = -1 


Array 1 ndexOutOfBou ndsExcep 
tion is thrown 




5 


Length > mask.length 

Call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 18 


ArraylndexOutOfBoundsExcep 
tion is thrown 




6 


Offset + length > mask.length 

Call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 9 

length = 9 


ArraylndexOutOfBoundsExcep 
tion is thrown 




7 


Length < 

Call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = -1 


ArraylndexOutOfBoundsExcep 
tion is thrown 




8 


length = 

call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 


Returns true 




9 


Check all the Terminal Profile 

Call check {) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 

length = 16 


Returns false because facility 
15 is not supported 




10 


Check a part of the Terminal Profile 

Call check { ) method: 

mask = 0XFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

offset = 15 

length = 2 


Returns true: the 16 first 
facilities except facility 15 have 
been successfully checked 





ETSI 



Release 6 



438 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


11 


Check a part of the Terminal Profile 

Call check {) method: 
mask = 0x0080 
offset = 
length = 2 


Returns false: only facility 15 is 
checked and not supported. 





5.2.1 6.3 Method check(short index) 

Test Area Reference: Api_2_Tep_Checs. 
5.2.16.3.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check {short index) 

throws ToolkitException 



5.2.16.3.1.1 



Normal execution 



• CRRNl: The method checks a facility in the handset profile: returns true if the facility is supported, false if 
facility is not supported, or if facility-index outside TerminalProfile data. 

• CRRN2: returns false if facility-index is outside Terminal Profile data. 

5.2.16.3.1.2 Parameter errors 

• CRRP 1 : shall throw B AD_INPUT_PARAMETER ToolkitException if index has a negative value. 

5.2.16.3.1.3 Context errors 

• CRRC 1 : shall throw TERMIN AL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal Profile data 
are not available. 

5.2.16.3.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND. 
Test Source: Test_Api_2_Tep_Checs.java. 
Test Applet: Api_2_Tep_Checs_l.java. 

Cap File: api_2_tep_checs.cap. 



5.2.16.3.3 



Test coverage 



CRR number 


Test case number 


N1 


2, 3,4 


N2 




P1 




C1 


1 
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5.2.16.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

1- Triggerapplet with status command 

2- Call check {) method with index = 1 


1 - applet is triggered 
2- 

TERMINAL_PROFILE_NOT_AVAI 
LABLE Tooll<itException is thrown 




2 


Terminal Profile, Facility is supported 

1- Trigger applet with unrecognized 
envelope 

2- Call check {) method with index = 


Returns true 




3 


Facility is not supported 

Call check { ) method with index = 15 


Returns false 




4 


Facility index is outside TerminalProfile data 

Call check {) method with index = 0x0099 


Returns false 




5 


Index has a negative value 

Call check {) method with index = -1 


Tfirows a ToolkitException with 
BAD_INPUT_PARAMETER reason 
code. 





5.2.1 6.4 Method getValue(short indexMSB, short indexLSB) 

Test Area Reference: Api_2_Tep_Gval. 

5.2.16.4.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static short getValue {short indexMSB, 

short indexLSB) 
throws ToolkitException 



5.2.16.4.1.1 



Normal execution 



• CRRNl: The method returns the binary value of a parameter, delimited by two indexes, from the handset 
profile. 



5.2.16.4.1.2 



Parameter errors 



CRRPl: The method shall throw BAD_INPUT_PARAMETER ToolkitException if (indexMSB >= indexLSB 
+16) or (indexMSB < indexLSB) or (indexMSB < 0) or (indexLSB < 0). 



5.2.16.4.1.3 



Context errors 



• CRRC 1 : The method shall throw TERMIN AL_PROFILE_NOT_AVAILABLE ToolkitException if Terminal 
Profile data are not available. 

5.2.16.4.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND. 
Test Source: Test_Api_2_Tep_Gval.java. 
Test Applet: Api_2_Tep_Gval_l.java. 

Cap File: api_2_tep_gval.cap. 
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5.2.16.4.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


4, 5, 6, 7 


C1 


1 



5.2.16.4.4 Test procedure 

TP = FF 01 D2 FO 00 00 00 00 00 00 00 00 00 8D FF 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
Call getValueO method: 
indexMSB = 15, indexLSB = 


TERMINAL_PROFILE_NOT_AVAI 
LABLE ToolkitException is thrown 




2 


Retrieve number of character down Terminal 
display in Terminal Profile which is 13 

Call getValueO method: 
indexMSB = 108, indexLSB = 104 


Returns 13 




3 


Retrieve byte 3 and byte 4 from terminal 
profile. 

Byte 3 = 0xD2 , Byte 4 = OxFO 
Call getValueO method: 
indexMSB = 31, indexLSB =16 


Returns 0xF0D2 




4 


indexMSB is negative 

call getValueO method: 

indexMSB = OxFFFF, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




5 


indexLSB is negative 

Call getValue method: 

indexMSB = 0x0002, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




6 


indexMSB < indexLSB 

Call getValueO method: 

indexMSB = 0x0002, indexLSB = 0x0003 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




7 


indexMSB > indexLSB + 16 

Call getValueO method: 

indexMSB = 0x0021, indexLSB = 0x0010 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




8 


indexMSB = indexLSB + 16 

Call getValueO method: 

indexMSB = 0x0020, indexLSB = 0x0010 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




9 


indexMSB is outside data available 

Call getValueO method: 
indexMSB = 121, indexLSB = 115 


Returns 0x001 F 





5.2.1 6.5 Method copy(short startOffset, byte[] dstBuffer, short dstOffset, short 
dstLength) 

Test Area Reference: Api_2_Tep_Copy. 
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5.2.16.5.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static short copy{short startOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws ToolkitException 

5.2.16.5.1.1 Normal execution 

• CRRN 1 : The method copies a part of the handset profile in a buffer. 

• CRRN2: The method returns dstOffset + dstLength. 

5.2.16.5.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2 : //"dstOffset or dsthength parameter is negative an 
ArraylndexOutOf BoundsException exception is thrown and no copy is performed. 

• CRRP3: /fdstOf f set+dstLength is greater than dstBuffer. length, the length of the dstBuffer 
array an ArraylndexOutOf BoundsException exception is thrown and no copy is performed. 



5.2.16.5.1.3 



Context errors 



• CRRC 1 : The method shall throw TERMIN AL_PROFILE_NOT_AV AILABLE ToolkitException if Terminal 
Profile data are not available. 

5.2.16.5.2 Test area files 

Specific triggering: EVENT_STATUS_COMMAND. 
Test Source: Test_Api_2_Tep_Copy.java. 
Test Applet: Api_2_Tep_Copy_l.java. 

Cap File: api_2_tep_copy.cap. 



5.2.16.5.3 



Test coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11 


N3 


8,9,10,11 


P1 


2 


P2 


4,5 


P3 


3,6,7 


C1 


1 



5.2.16.5.4 Test procedure 

TP = FF 01 D2 FO 01 02 00 00 00 00 00 00 00 8D FF 
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Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
Call copyO method: 
startOffset = 
dstBuffer. length = 6 
dstOffset = 
dstLength = 6 


TERMINAL_PROFILE_NOT_AVAI 
LABLE ToolkitException is thrown 




2 


dstBuffer Is null 


NullPointerException is thrown 




3 


dstOffset > dstBuffer.length 

Call copyO method: 
StartOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


Array IndexOutOfBoundsException 
is thrown 




4 


dstOffset < 

Call copyO method: 
StartOffset = 
dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException 
is thrown 




5 


dstLength < 

Call copyO method: 
StartOffset = 
dstBuffer.length = 5 
dstOffset = 1 
dstLength = -1 


ArraylndexOutOfBoundsException 
is thrown 




6 


dstLength >dstBuffer.length 

Call copyO method: 
StartOffset = 
dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException 
is thrown 




7 


dstOffset + dstLength >dstBuffer.length 

Call copyO method: 
StartOffset = 
dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsException 
is thrown 




8 


Successful call extreme values 

Call copy { ) method: 
StartOffset = 
dstBuffer.length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 




9 


Successful call any values 

Call copyO method: 
StartOffset = 1 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyO is 7 




10 


Successful call, copy with length =0 

Call copyO method: 
StartOffset = 
dstBuffer.length = 20 
dstOffset = 20 
dstLength = 


Result of copyO is 20 




11 


Value outside ProfileDownload data available 

Call copyO method: 
StartOffset = 13 
dstBuffer.length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 
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5.2.17 Class ToolkitRegistrySystem 

5.2.17.1 Method getEntry 

Test Area Reference: Api_2_Trs_Gety. 

5.2.1 7.1 .1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntry {) 

throws ToolkitException 

5.2.1 7.1 .1 .1 Normal execution 

• CRRNl : returns a reference to the applet ToolkitRegistry object of the calling applet. 

• CRRN2: Each successive call to getEntryO method shall return the same object. 

5.2.17.1.1.2 Parameter errors 
No requirements. 

5.2.17.1.1.3 Context errors 

• CRRCl: This method returns null if the Applet.register() has not yet been invoked. 

• CRRC2: This method returns null if the server does not exist. 

• CRRC3: This method returns null if the server returns null. 

• CRRC4: ToolkitException with REGIS TRY_ERROR reason code shall be thrown in any case of register 
error. 



5.2.17.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.17.1.3 



Test area files 

Test_Api_2_Trs_Gety .j ava. 
Api_2_Trs_Gety_l .Java. 
api_2_trs_gety .cap . 

Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


3 


C1 


1 


C2 


Not testable 


C3 


Not testable 


C4 


Not testable 
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5.2.17.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call before registerQ method 

In the constructor, the applet instance 
calls the getEntryO method. 


Returns null 




2 


Call after register() method 

In the install method and after the call 
to register {) method, call the getEntryO 
method . 


A not null reference is returned. 
No exception shall be thrown 




3 


Check it returns the same entry 

The applet calls the getEntryO method 
again, in the processToolkit { ) method. 


Returns the same ToolkitRegistry 
object reference as for test case 2. 





5.2.18 Class ToolkitException 



5.2.18.1 ToolkitException Constructor 

Test Area Reference: Api_2_Tke_Coor. 

5.2.1 8.1 .1 Conformance requirement: 

The constructor with following header shall be compliant to its definition in the API. 

public ToolkitException {short reason) 

5.2.18.1.1.1 Normal execution 

• CRRNl: Construct a ToolkitException instance with the specified reason. 



5.2.18.1.1.2 
No requirements. 

5.2.18.1.1.3 
No requirements. 

5.2.18.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.18.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Tke_Coor.j ava. 
Api_2_Tke_Coor_l .j ava. 
api_2_tke_coor. cap . 

Test coverage 



CRR number 


Test case number 


N1 


1 



5.2.18.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 1 9 


ToolkitException.getReasonO = 
(short) 19 
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5.2.18.2 Method throwit 

Test Area Reference: Api_2_Tke_Thit. 

5.2.18.2.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static void throwit {short reason) 

throws ToolkitException 

5.2.18.2.1.1 Normal execution 

• CRRNl : Throws the JCRE instance of the ToolkitException class with the specified reason. 

• CRRN2: extends javacard.framework.CardRuntimeException. 



5.2.18.2.1.2 
No requirements. 

5.2.18.2.1.3 
No requirements. 

5.2.18.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.2.18.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_2_Tke_Thit.j ava. 
Api_2_Tke_Thit_ 1 .j ava. 
api_2_tke_thit.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



5.2.18.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Tlirows the JCRE instance of ToolkitException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 0xA55A 




4 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 0xA55A 





5.2.18.3 Reason Codes 

Test Area Reference: Api_l_Tke_Cons. 
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5.2.18.3.1 Conformance Requirement 

There is no API, only constants. These constants shall compliant to its definition in the API. 

5.2.18.3.1.1 Normal execution 

• CRRNl: The Constants of the class ToolkitException shall all have the same name and value defined in the 
TS 102 241 [9]. 

• CRRN2: Constructs ToolkitException an Exception with the specified reason. 



5.2.18.3.1.2 
No requirements. 

5.2.18.3.1.3 
No requirements. 

5.2.18.3.2 
None. 



Parameter errors 



Context errors 



Test area files 



5.2.18.3.3 



Test Coverage 



CRR number 



Test case number 



N1 &N2 



The constants in Java are resolved at compilation time, therefore a runtime test is not 
useful. No test of constants will be performed 



5.2.18.3.4 
None. 



Test Procedure 
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5.3 Package uicc.access.fileadministration 

5.3.1 Interface AdminFileView 

5.3.1 .1 Method createFile(ViewHandler viewHandler) 

Test Area Reference: Api_4_Afv_Crtf. 

5.3.1 .1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void createFile {ViewHandler viewHandler) 

throws Java . lang. Null Point erExcept ion, 
UICCException, 
AdminException, 
j avacard . framework . TransactionException 

5.3.1.1.1.1 Normal execution 

• CRRNl: This method creates a new file under the current DF or ADF, as described in TS 102 222 [7]. 

5.3.1.1.1.2 Parameter errors 

• CRRPl: If viewHandler is null, an instance of Java. lang. NullPointerException shall be thrown. 

• CRRP2: If the viewHandler parameter includes incorrect parameters, an instance of AdminException shall be 
thrown. The reason code shall be AdminException.INCORRECT_PARAMETERS. 

5.3.1.1.1.3 Context errors 

• CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC3: If the file identifier of the EF being created already exists, an instance of AdminException shall be 
thrown. The reason code shall be AdminException.FILE_ALREADY_EXISTS. 

• CRRC4: If the DF name already exists, an instance of AdminException shall be thrown. The reason code shall 
be AdminException.DF_NAME_ALREAD Y_EXISTS . 

• CRRC5: If there is not enough memory, an instance of AdminException shall be thrown. The reason code 
shall be AdminException.NOT_ENOUGH_MEMORY_SPACE. 

• CRRC6: If the access conditions are not satisfied, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.SECURITY_STATUS_NOT_SATISFIED. 

5.3.1.1.2 Test area files 

Test Source: Test_Api_4_Afv_ Crtf.java. 
Test Applet: Api_4_Afv_ Crtf _1 .Java. 

Cap File: api_4_Afv_ Crtf.cap. 
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5.3.1.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4 


C1 


Not testable 


C2 


Not testable 


C3 


5 


C4 


6 


C5 


Not testable 


C6 


7 



5.3.1.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Create an EF 

1- applet is triggered by sending an 
unrecognized envelope 

2- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR_ON_RESET) 

3- select MF/DFtest 

4- create transparent EFrfuo {6F29) 

5- select EFrfuo, Update binary 12 34 56 

6- create Linear fixed EFrfui 

7- select EFrfui, Update record 01 

8- create Cyclic EFrfu2 

9- select EFrfu2, update record 01 
record: 1 

value: 12 34 56 

Applet finalizes 

10- select MF/DFtest/EFrfuo, read binary 

11- select MF/DFtest/EFrfui, read record 1 

12- select MF/DFtest/EFrfu2 , read record 1 


4- no exception shall be thrown 


10- returns: 12 34 56 

11- returns: 02 

12- returns: 12 34 56 


2 


Create a DF in ADF1 

1- applet is triggered by sending an 
unrecognized envelope 

2- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w {AID_ADF1 , CLEAR_ON_RESET) 

3- select ADFI/DFtest 

4- create DFrfui {5F01) 

5- select DFrfui 

6- create EFrfui {6F2A) 

7- select EFrfui, update binary 12 34 56 
Applet finalizes 

8- select ADFI/DFtest/EFrfui {6F2A) , read 
binary 

9- Reset 




8- returns: 12 34 56 


3 


Call createFile with a null viewHandler 

1- call createFile {) with null. 


1- java.lang.NullPointerException shall be 
thrown 




4 


Call createFile with incorrect parameters 

1- call createFile with incorrect 
parameters . 


1- 

AdminException.lNCORRECT_PARAME 
TERS shall be thrown 




5 


EF already exists 

1- Select MF/DFtest 

2- Call createFile (EFtaru) 


2- 

AdminException.FILE ALREADY EXIST 

S 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


DF already exists 

1- Call createFile (DFtest) 


1- 

AdminException.DF NAME ALREADY 

EXISTS 




7 


Security status not satisfied 

1- Select MF/DFtest/DFshe2 

2- Call createFile {) to create some 
transparent file. 


2- 

UlCCException.SECURITY STATUS N 

OT SATISFIED 





5.3.1 .2 Method deleteFile(short fid) 

Test Area Reference: Api_4_Afv_Dltf. 

5.3.1.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deleteFile {short fid) 

throws UICCException, 

j avacard . framework . TransactionException 



5.3.1.2.1.1 



Normal execution 



• CRRNl: This method initiates the deletion of an EF immediately under the current DF, or a DF with its 
complete subtree, as described in TS 102 222 [7]. 



5.3.1.2.1.2 
Not applicable 

5.3.1.2.1.3 



Parameter errors 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

CRRC3: If the file cannot be found in the current directory, an instance of UICCException. shall be thrown. 
The reason code shall be UICCException. FILE_NOT_FOUND. 

CRRC4: If the access conditions are not satisfied, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC5: If the operation would cause the commit capacity to be exceeded, an instance of 
javacard.framework.TransactionException shall be thrown. 



5.3.1.2.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_ Dltf.java. 
Api_4_Afv_ Dltf _l.java. 
api_4_Afv_ Dltf.cap. 
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5.3.1.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


CI 


Not testable 


C2 


Not testable 


C3 


5 


C4 


6 


C5 


Not testable 



5.3.1.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Initialization 

1- applet is triggered by sending an 
unrecognized envelope 

2- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFileVi 
ew {CLEAR_ON_RESET) 

3- select MF/DFtest 

4- create DFrfdi 

5- select DFrfoi 

6- create DFrfd2 , create EFrfui, create EFrfd2 

7- select DFRFn2 

8- create EFrfui 

9- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileView {A 
ID_ADF1 , CLEAR_ON_RESET) 

10- select MF/DFtest 

11- create DFrfui 

12- select DFrfdi 

13- create DFrfd2 , create EFrfui, create 

EFrfU2 

14- select DFrfu2 

15- create EFrfui 






1 


Delete EF 

1- Select MF/DFtest/DFrfui 

2- call deleteFile (EFrfui) 

3- Select MF/DFtest/DFrfui/EFrfui 


2- no exception shall be thrown 

3- UlCCException.FILE NOT FOUND is thrown 




2 


Delete EF in ADF1 

1- Select ADFI/DFtest/DFrfui 

2- call deleteFile (EFrfui) 

3- Select ADFI/DFtest/DFrfui/EFrfui 


2- no exception shall be thrown 

3- UICCException.FILE_NOT_FOUND is thrown 




3 


Delete DF and its subtree 

1- Select MF/DFtest 

2- call deleteFile (DFrfui) 

3- Select MF/DFtest/DFrfui 


2- no exception shall be thrown 

3- UICCException.FILE_NOT_FOUND is thrown 




4 


Delete DF and its subtree in ADF1 

1- Select ADFI/DFtest 

2- call deleteFile (DFrfui) 

3- Select ADFI/DFtest/DFrfui 


2- no exception shall be thrown 

3- UlCCException.FILE NOT FOUND is thrown 




5 


File not found 

1- Select MF/DFtest 

2- call deleteFile (DFrfui) 

3- Select ADFI/DFtest 

4- call deleteFile (EFrfui) 


2- UICCException.FILE_NOT_FOUND 
4- UICCException.FILE_NOT_FOUND 




6 


Security status not satisfied 

1- Select MF/DFTEST/DFARR2 

2- call deleteFile (EFtar2t) 


2- 

UlCCException. SECURITY STATUS NOT SA 

TISFIED 
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5.3.1.3 Method resizeFile(ViewHandler viewHandler) 

Test Area Reference: Api_4_Afv_Rszf. 

5.3.1.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void resizeFile {ViewHandler viewHandler) 

throws Java . lang. Null Point erExcept ion, 
UICCException, 
AdminException, 
j avacard . framework . TransactionException 

5.3.1.3.1.1 Normal execution 

• CRRNl: This method resizes a file under the current DF or ADF, as described in TS 102 222 [7]. 

5.3.1.3.1.2 Parameter errors 

• CRRPl: If viewHandler is null, an instance of Java. lang. NullPointerException shall be thrown. 

• CRRP2: If the viewHandler parameter includes incorrect parameters, an instance of AdminException shall be 
thrown. The reason code shall be AdminException.INCORRECT_PARAMETERS. 

5.3.1.3.1.3 Context errors 

• CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC3: If the file cannot be found in the current directory, an instance of UICCException. shall be thrown. 
The reason code shall be UICCException. FILE_NOT_FOUND. 

• CRRC4: If the access conditions are not satisfied, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC5: If the operation would cause the commit capacity to be exceeded, an instance of 
javacard.framework.TransactionException shall be thrown. 

• CRRC6: If there is not enough memory, an instance of AdminException shall be thrown. The reason code 
shall be AdminException.NOT_ENOUGH_MEMORY_SPACE. 

• CRRC7: If the conditions of use are not satisfied, an instance of AdminException shall be thrown. The reason 
code shall be AdminException.CONDITIONS_OF_USE_NOT_SATISFIED. 

• CRRC8: If the method resizeFile() is applied to a non compatible file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

• CRRC9: If the method resizeFile() is applied to invalidated data, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.REF_DATA_INVALIDATED. 

5.3.1.3.2 Test area files 

Test Source: Test_Api_4_Afv_ Rszf.java. 
Test Applet: Api_4_Afv_ Rszf _1 .Java. 

Cap File: api_4_Afv_ Rszf cap. 
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5.3.1.3.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4 


CI 


Not testable 


C2 


Not testable 


C3 


5 


C4 


6 


C5 


Not testable 


C6 


Not testable 


C7 


Not testable 


C8 


7 


C9 


8 



5.3.1.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Resize a Transparent EF 

1- Trigger the applet with an unrecognized 
envelope 

2- Select MF/DFtest 

3- Call ResizeFileO on EFtahu 

new size: 10 bytes 

Applet finalizes 

4- Select MF/DFtest/EFtaru and check size in 
the returned FCP template . 

5- Restore EFtaru 




4- should return a size 
of 1 bytes 


2 


Resize a Linear Fixed EF 

1- Trigger the applet with an unrecognized 
envelope 

2- Select MF/DFtest 

3- Call ResizeFileO on EFLARU 

add 2 records . 

Applet finalizes 

4- Select MF/DFtest/EFlaru and check size in 
the returned FCP template. 

5- Restore EFlaru 




4- should return a size 
of 1 6 bytes 


3 


Call resizeFile with a null viewHandler 

1- Call resizeFile with null. 


1- java.lang.NullPointerException shall be 
thrown 




4 


Call createFile with incorrect parameters 

1- Call createFile with incorrect 
parameters . 


1- 

AdminExceptiogn.lNCORRECT_PARAMETERS 
shall be thrown 




5 


File not found 

1- Select MF/DFtest 

2- Call resizeFile {DFrfhi) 

3- Select ADFI/DFtest 

4- Call resizeFile (EFrfui) 


2- UICCException.FILE_NOT_FOUND shall be 
thrown 

4- UICCException.FILE_NOT_FOUND shall be 
thrown 




6 


Security status not satisfied 

1- Select MF/DFTEST/DFARR2 

2- Call resizeFile {EFtar2t) 


2- 

UICCException.SECURITY_STATUS_NOT_SA 
TISFIED shall be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Command incompatible 

1- Select MF/DFtest, call resizeFile (EFcaru) 


l-UICCException.COMMANDJNCOMPATIBLE 
shall be thrown 




8 


Invalidated data 

1- Select MF/DFtest 

2- Invalidate EFtaeu 

3- Call resizeFile (EFtaeu) 

4- Validate EFtaeu 


3-UICCException.REF_DATA_INVALIDATED 
shall be thrown. 





5.3.1 .4 Method select (byte sfi) 

Test Area Reference: Api_4_Afv_Slctb. 
5.3.1.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void select {byte sfi) 

throws UICCException 

5.3.1.4.1.1 Normal execution 

• CRRNl: Selects a file by its Short File Identifier in the current directory of the FileView. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: The current EF it self can be selected. 

• CRRN4: The file context associated with the FileView object is changed after successful execution. 

5.3.1.4.1.2 Parameter errors 

• CRRPl : If the file which sfi matches is not in the current directory or no file matches the sfi, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 



5.3.1.4.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.4.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_ Slctb.java. 
Api_4_Afv_ Slctb _l.java. 
api_4_Afv_ slctb. cap. 
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5.3.1.4.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,4 


N2 


Not testable 


N3 


3 


N4 


5 


P1 


4 


C1 


Not testable 


C2 


Not testable 



5.3.1.4.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Selection possibilities, UICC file system 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR_ON_RESET) 

2- select DFtest, fid=llll 

3- select with sfi EFthr, sfi = 0x01 

4- select with sfi EFthu, sfi = 0x02 

5- select with sfi EFcnu, sfi = 0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w {AID_ADF1 , CLEAR_ON_RESET) 

2- select DFtest, fid=llll 

3- select with sfi EFtke, sfi = 0x01 

4- select with sfi EFtkd, sfi = 0x02 

5- select with sfi EFcnu, sfi = 0x05 


2- no exception shall be thrown 

3- no exception shall be thrown 

4- no exception shall be thrown 

5- no exception shall be thrown 




3 


Current EF Itself can be selected 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR_ON_RESET) 

2- select DFtest, fid=llll 

3- select with sfi EFthr, sfi = 0x01 

4- select with sfi EFthr, sfi = 0x01 


4- no exception shall be thrown 




4 


FILE_NOT_FOUND 

1- try to select a file with sfi=0x55 


1- shall throw an 
uicc.access.UICCException with 
reason code FILE NOT FOUND 




5 


File context changed 

1- select EFtaru, sfi = 0x03 
read 3 first bytes 

2- select EFthd, sfi = 0x02 
read file content 


1 - file content should be 

{OxFF,OxFF,OxFF} 

2- file content should be 

{0x55,0x55,0x55} 





5.3.1 .5 Method select(short fid, byte[] fcp, short fcpOffset, short fcpLength) 

Test Area Reference: Api_4_Afv_Slctb_bss. 



5.3.1.5.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short select {short fid, 
byte [] fcp, 
short fcpOffset, 
short fcpLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 
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5.3.1.5.1.1 Normal execution 

CRRNl: Selects a file of the UICC file system or of an ADF file system as defined in TS 102 221 [5]. 

CRRN2: The method returns the FCP information in a form of a TLV structure as specified in TS 102 221 [5]. 

CRRN3: If the fcpLength is greater than the length of the response, the whole response is copied into the fcp 
buffer and the length of the response is returned by the method. 

CRRN4: If the fcpLength is smaller than the length of the response, the first part of the response is copied into 
the fcp buffer and the fcpLength is returned by the method. 

CRRN5: After selecting a ADF/MF/DF no EF is selected. 

CRRN6: After selecting a linear fixed EF no record is selected. 

CRRN7: After selecting a cyclic EF the last updated record is the first record. 

CRRN8: Any file can be selected by FID which is an immediate child of the current directory. 

CRRN9: Any DF can be selected by FID which is an immediate child of the parent of the current DF. 

CRRNIO: The parent of the current directory can be selected by the FID. 

CRRNl 1: The ADF of the current active application can be selected by the FID. 

CRRN12: The ADF/MF can always be selected. 

CRRNl 3: The file context associated with the File View object is changed after successful execution. 

CRRN14: The current file context of any other applets shall not be changed. This will be tested during the 
testing of the framework. 

5.3.1.5.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcpLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset plus fcpLength is greater than the length of the array fcp. length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

5.3.1.5.1.3 Context errors 

• CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules, an 
instance of UICCException shall be thrown. The reason code shall be UICCException.FILE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

5.3.1.5.2 Test area files 

Test Source: Test_Api_4_Afv_Slctb_bss.java. 
Test Applet: Api_4_Afv_Slctb_bss_l.java. 

Cap File: Api_4_Afv_slctb_bss.cap. 
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5.3.1.5.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8, 14, 18,20,21 


N2 


1,2,3,4,5,6,7,8, 14, 18,20,21 


N3 


1 


N4 


2, 3, 4 ,5, 6, 7, 8 


N5 


15,19 


N6 


17 


N7 


18 


N8 


14 


N9 


14 


N10 


14 


N11 


19,20 


N12 


20 


N13 


20 


N14 


1,2,3,4,5,6,7,8, 14, 18,20 


P1 


9 


P2 


10 


P3 


11 


P4 


12, 13 


CI 


16 


C2 


Not testable 


C3 


Not testable 



5.3.1.5.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get an AdminFileView object, UICC file 
system 

get an AdminFileView 

FileView.getTheUICCAdminFileView{CLEAR_0 
N RESET) 






1 


Select EFTARU in MF (Transparent EF) 

Select DFtest 

select EFtaeu, 

fid=6F03 

byte[] fcp = new byte [132] 

fcpOffset = 

fcpLength = 127 


Shall return at least 19. 

fcp[] shall contain following TLVs: 

1 . 82 02 41 21 //file descriptor 

2. 83 02 2F E2 //file id 

3. 8A 01 05 //life cycle status 

4. 80 02 00 OA // file size 




2 


Select EFTARU in MF (Transparent EF) 

select EFtard, 
fid=6F03 
fcpOffset = 
fcpLength = 7 
select {) 


Shall return 7. 

fcp[] shall contain the first 7 bytes of 

the POP structure and contain 

following TLV. 

1 . 82 02 41 21 //file descriptor 




3 


Select DFTEST in MF 

fid = DFtest, fid=llll 
fcpOffset = 
fcpLength = 127 
select { ) 


Shall return at least 17. 

fcp[] shall contain following TLVs 

1 . 82 02 78 21 //file descriptor 

2. 83 02 1 1 11 //file id 

3. 8A 01 05 //life cycle status 




4 


Select EFCARU in DFTEST (Cyclic EF) 

select EFcARu, 
fid=6f09 
fcpOffset = 
fcpLength = 11 
select {) 


Shall return: 11 

fcp[] shall contain following TLV: 

82 05 46 21 00 03 02 




5 


Select ADF1 

select ADF 

fid=7FFF 

fcp [0:5] =0x00 

fcpOf f set=5 

fcpLength=127 

select 


Shall return: at least 27 

The first 5 bytes of fcp[] shall be 0x00 

and contains following TLVs: 

1 . 82 02 78 21 //file descriptor 

2. 84 1 AO 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A 01 05 //life cycle 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Select MF 

select MF, 
fid= 3F00 
fcpOffset = 
fcpLength = 11 
select { ) 


Shall return: 11 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




7 


Select DFTELECOM in MF 

select DFtelecom, 

fid=7F10 

fcp[0] = fcp[l] = 0x05 

fcpOffset = 2 

fcpLength = 13 

select {) 


Shall return 13. 

The first 2 bytes of fcp[] shall be 0x05 

and fcp[] shall contain following TLVs 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 10 //file id 




8 


Select EFLARU in DFTELECOM (Linear 
FixedEF) 

select EFlahu, 
fid = 6F0C 
fcpOffset = 
fcpLength = 14 


Shall return 14. 

fcp[] shall contain following TLVs: 

1.82 05 42 21 00 04 02 

2. 83 02 6F OC 




9 


fcp is null 

select EFlahd, 

fid = GFOC 

byte[] nullBuffer = null 

fcpOffset = 

fcpLength = 15 


Shall throw 
java.lang.NullPointerException 




10 


fcpOffset < 

select EFlaeu, 
fid = 6F0C 
fcpOffset = -1 
fcpLength = 15 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




11 


fcpLength < 

select EFlaru, 
fid = 6F0C 
fcpOffset = 
fcpLength = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




12 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 
fid = 6F0C 
fcpOffset = 115 
fcpLength = 18 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




13 


fcpOffset + fcpLength > fcp.length 

select EFlaru, 

fid = 6F0C 

fcpOffset = f cp . lengthH-1 

fcpLength = 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption 




14 


Selection possibilities 

0- select MF, fid=3F00 

1- select EFnicc, fid=2FF0 

2- select DFtest, fid=llll 

3- select EFcnu, fid=6F05 

4- select EFtaaa, fid=SFlS 

5- select DFsub_test, fid=2211 

6- select DFtest, fid=llll 

7- select EFtaaa, fid=GF16 

8- select DFtest, fid=llll 

9- select MF, fid=3F00 

10- select DFtest, fid=llll 

11- select EFtaaa, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown. 




15 


EF not selected after MF/DF selection 

1- select MF, 
fid = 3F00 
select EFicciD, 
fid = 2FE2 
2 - select MF 
fid = 3F00 
select { ) 
readBinary { ) 


2 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


No selection of non-reachable file 

1 - select MF, 
fid = 3F00 

2 - select EFcaeu, 
fid= Ox6F09 


2 - Shall throw 

uicc.access.UICCException with 
reason code FILE_NOT_FOUND. 




17 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 
fid=llll 

3- select EFlaeu, 
fid=6F0C 

4 - recNumber = 

mode = REC_ACC_M0DE_ CURRENT 

readRecord { ) 


4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND. 




18 


Record pointer in selected cyclic EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 
fid=llll 

3- select EFcaeu, 
fid=6F09 

4- byte[] datal = { 1,2,3 } 
mode = REC_ACC_MODE_PREVIOUS 
updateRecord (datal) 

5- select EFcaeu 
fid = SF09 
select { ) 

mode = REC_ACC_MODE_PREVIOUS 
readRecord ( ) 
readRecord {data2 ) 
compare datal to data2 

6- restore original data of EFcaeu 


5 - The contents of datal and data2 
shall be identical. 




19 


EF not selected after ADF/DF selection 

1- get an AdminFileView 
AdminFileViewBuilder . getTheAdminFileView 

{AID_ADF1 , CLEAR_ON_RESET) 

2- select ADF, 
fid = 7FFF 
select EFuicc, 
fid = 2FF0 

3 - select ADF 
fid = 7FFF 
select { ) 
readBinary { ) 


3 - Shall throw 

uicc.access.UICCException with 
reason code NO_EF_SELECTED. 
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Reselection 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select ADF, fid=7FFF 

2- Using the UICC FileView 
select MF, fid=3F00 
select MF, fid=3F00 

3- select DFtest, fid=llll 
select DFtest, fid=llll 

5- select EFtaaa, fid=6F16 
select EFtaaa, fid=SF16 


No exceptions shall be thrown 
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Security attributes 

1- Using the ADF FileView 
select ADF, fid=7FFF 
select DFtest, fid=llll 
select EFlaeei, fid=6FAl 

2- Using the UICC FileView 
select MF, fid=3F00 
select DFtest, fid=llll 
select EFtaeh3, fid=6FB3 


1 - fcp[] shall contain the following TLV 

SB 03 AC 00 01 or 

SB 06 AC 00 00 01 01 01 

2- fcp[] shall contain the following TLV 

SB 03 AC 00 03 or 

SB 06 AC 00 00 03 01 03 
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5.3.1 .6 Method select (short fid) 

Test Area Reference: Api_4_Afv_Slcts. 

5.3.1.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public public void select {short fid) 
throws UICCException 

5.3.1.6.1.1 Normal execution 

• CRRNl : Selects a file of the UICC file system or of an ADF file system by file identifier. 

• CRRN2: Allows to update the current file without handling the Select Response. 

• CRRN3: After selecting a ADF/MF/DF no EF is selected. 

• CRRN4: After selecting a linear fixed EF no record is selected. 

• CRRN5: Any file can be selected by FID which is an immediate child of the current directory. 

• CRRN6: Any DF can be selected by FID which is an immediate child of the parent of the current DP. 

• CRRN7: The parent of the current directory can be selected by the FID. 

• CRRN8: The ADF of the current active application can be selected by the FID. 

• CRRN9: The ADF/MF/EF can always be self selected. 

• CRRNIO: The file context associated with the File View object is changed after successful execution. 

5.3.1.6.1.2 Parameter errors 
No requirements. 

5.3.1.6.1.3 Context errors 

• CRRCl: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN3, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC2: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN4, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC3: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN5, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC4: If the file with a File Identifier which matches fid could not be found according to the selection rule 
listed in CCRN6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.FILE_NOT_FOUND. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.3.1.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.6.3 



Test area files 

Test_Api_4_Afv_Slcts.java. 
Api_4_Afv_Slcts_l .Java. 
api_4_Afv_slcts.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


5 


N3 


5 


N4 


6 


N5 


1,2 


N6 


1,2 


N7 


1,2 


N8 


1,2 


N9 


4 


N10 


Tested in Api 1 Cent, test case 1 and 2 


C1 


3 


C2 


3 


C3 


3 


C4 


3 


C5 


Not testable 


C6 


Not testable 



5.3.1.6.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get an AdminFileView object, UICC file 
system 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR ON RESET) 






1 


Selection possibilities 

1- select EFuicc, fid=2FF0 

2- select DFtest, fid=llll 

3- select EFcnd, fid=6F05 

4- select EFtaaa, fid=6F16 

5- select DFsub test, f id=2211 

6- select DFtest, fid=llll 

7- select EFtaaa, fid=6F16 

8- select DFtest, fid=llll 

9- select MF, fid=3F00 

10- select DFtest, fid=llll 

11- select EFtaaa, fid=6F16 

12- select MF, fid=3F00 


No exception shall be thrown 




2 


Selection possibilities, ADF1 

1- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w {AID_ADF1 , CLEAR_ON_RESET) 

2- select EFdicc, fid=2FF0 

3- select DFtest, fid=llll 

4- select EFcnd, fid=6F05 

5- select EFtaaa, fid=6F16 

6- select DFsub test, fid=2211 

7- select DFtest, fid=llll 

8- select EFtaaa, fid=SFlS 

9- select DFtest, fid=llll 


No exception shall be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


No selection of unreachable file 

1- get an AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR_ON_RESET) 

2- select EFcm, fid=6F05 

3- select DFtest, fid=llll 

4- select EFtaa, fid=2222 

5- select EFcnd, fid=6F05 

6- select DFsub test, fid=2211 

7- select EFtaa, fid=2222 

8- select DFtelecom, fid=7F10 


2- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

3- No exception shall be thrown 

4- A 

UICCException.FILE_NOT_FOUND 

shall be thrown. 

5- No exception shall be thrown 

6- No exception shall be thrown 

7- No exception shall be thrown 
8- A 

UICCException.FILE_NOT_FOUND 
shall be thrown. 




4 


Self selection 

1- select MF, fid=3F00 

2- select MF, fid=3F00 

3- select DFtest, fid=llll 

4- select DFtest, fid=llll 

5- select EFtaaa, fid=6F16 

6- select EFtaaa, fid=6F16 

7- get an AdminFileView 

AdminFileViewBuilder . getTheAdminFileVie 
w {AID_ADF1 , CLEAR_ON_RESET) 

8- select ADF, fid=7FFF 

9- select ADF, fid=7FFF 


2- No exception shall be thrown 
4- No exception shall be thrown 
6- No exception shall be thrown 

8- No exception shall be thrown 

9- No exception shall be thrown 




5 


EF not selected after MF/DF selection 

1- select MF, fid=3F00 

2- updateRecord { ) 

3- select DFtest, fid=llll 

4- updateRecord { ) 


2- A 

UICCException.NO_EF_SELECTED 
shall be thrown 
4- A 

UICCException.NO_EF_SELECTED 
shall be thrown 




6 


No record is selected after selecting linear 
fixed EF 

1- select MF, 
fid = 3F00 

2- select DFtest, 

3- select EFlaru, 

4 - recNumber = 

mode = REC_ACC_M0DE_ CURRENT 

readRecord { ) 

5- select EFcaru, 

6 - recNumber = 

mode = REC_ACC_M0DE_ CURRENT 

readRecord { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND. 

5 - No exception shall be thrown. 

6 - Shall throw uicc.access.UICC 
Exception with reason code 
RECORD NOT FOUND. 





5.3.1.7 Method status 

Test Area Reference: Api_4_Afv_Stat. 

5.3.1.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short status {byte [] fcp, 

short fcpOffset, 
short fcpLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 
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5.3.1.7.1.1 



Normal execution 



• CRRNl : The method returns the File Control Parameter of the current selected DF/MF or ADF as defined in 
TS 102 221 [5]. 

• CRRN2: If the f cpLength is greater than the length of the response, the whole response is copied into the 
f cp buffer and the length of the response is returned by the method. 

• CRRN3: f the f cplength is smaller than the length of the response, the first part of the response is copied 
into the f cp buffer and the f cpLength is returned by the method. 

5.3.1.7.1.2 Parameter errors 

• CRRPl : If the array fcp is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fcpOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fcp Length is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fcpOffset+fcpLength is greater than fcp.length an ArraylndexOutOfBoundsException shall be 
thrown. 



5.3.1.7.1.3 



Context errors 



CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.7.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.7.3 



Test area files 

Test_Api_4_Afv_Stat.j ava. 

Api_4_Afv_Stat_l.java. 

Api_4_Afv_Stat.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2, 3, 4, 5, 11 


N2 


2,3 


N3 


1,4 


PI 


6 


P2 


7 


P3 


8 


P4 


9, 10 


CI 


Not testable 


C2 


Not testable 
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5.3.1.7.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Status of MF 

1- Get an AdminFileView object, UICC 
file get an AdminFileView 

FileView.getTheUICCAdminFileView{CLEAR_ 
ON_RESET) 

2- select MF 

byte[] fcp = new byte [127] 
fcp[0:2]= OxCC 
fcpOffset = 3 
fcpLength = 11 
status {) 


2- Shall return 1 1 . 

The first 3 bytes of fcp[] shall contain 

OxCC. 

fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 3F 00 //file ID 




2 


Status after select EFtaru in MF 

1 - select DFtest 
select EFtard, fid = 6F03 
fcpOffset = 
fcpLength = 127 
select {) 
status { ) 


1- Shall return at least 19. 
fcp[] shall contain following TLVs: 
1 . 82 02 38/78 21 //file descriptor 
2.83 02 11 11 //file ID 




3 


Status of DFtelecom 

1 - fid = 7F10 
fcpOffset = 
fcpLength = 127 
status { ) 


1 - 

Shall return at least 17 and the entire 
structure of the file control parameters. 
The file identifier shall be contain the 
fid of DFtelecom. 




4 


Status DFtelecom 

Select DFtelecom, fid=7F10 
fcpOffset = 
fcpLength = 11 
status {) 


Shall return 11. 

fcp shall contain the first 1 1 bytes of 
the FCP structure starting at index 0. 
fcp[] shall contain following TLVs: 

1 . 82 02 38/78 21 //file descriptor 

2. 83 02 7F 10 //file id 




5 


Status ADF1 

Select ADF, fid=7FFF 
fcpOffset = 
fcpLength =12 7 


Shall return at least 27 

fcp[] shall contain the entire FCP 

structure 

fcp[] shall contain following TLVs: 

1 . 82 02 78 21 //file descriptor 

2. 84 1 AO 00 00 00 09 00 05 FF FF 
FF FF 89 60 00 00 00 //DF Name 

3. 8A 01 05 //life cycle 




6 


fcp Is null 

byte[] nullBuffer = null 
fcpOffset = 
fcpLength = 34 
status {) 


Shall throw 
java.lang.NullPointerException. 




7 


fcpOffset < 

fcpOffset = -1 
fcpLength = 34 
status { ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




8 


fcpLength < 

fcpOffset = 
fcpLength = -1 
status { ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




9 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length-1 
fcpLength = 15 
status { ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 




10 


fcpOffset + fcpLength > fcp.length 

fcpOffset = fcp.length+1 
fcpLength = 
status { ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsExce 

ption. 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Security attributes 








1- Using the ADF FileView 
select ADF, fid=7FFF 


1 - fcp[] shall contain the following TLV 
8B 03 AC 00 02 or 






select DFtest, 

select DFsnE2, 

2- Using the UICC FileView 

select MF, fid=3F00 


8B 06 AC 00 00 02 01 02 

2- fcp[] shall contain the following TLV 

8B 03 AC 00 04 or 






select DFtest, 


88 06 AC 00 00 04 01 04 






select DFaKR4, 







5.3.1.8 Method readBinary 

Test Area Reference: Api_4_Afv_Redb. 

5.3.1.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short readBinary {short fileOffset, 

byte [] resp, 
short respOffset, 
short respLength) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 

5.3.1.8.1.1 Normal execution 

• CRRNl:. Reads the data bytes of the current transparent EF, as defined in TS 102 221 [5]. 

• CRRN2: The sum of respOffset plus respLength is returned, and the data bytes of the currently selected 
transparent file are returned in resp. 



5.3.1.8.1.2 



Parameter errors 



CRRPl: If fileOffset is negative, an instance of UICCException.OUT_OF_FILE_BOUND ARIES shall be 
thrown. 

CRRP2: If respOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: If respLength is negative, an instace of ArraylndexOutOfBoundsException shall be thrown. 

CRRP4: If the array resp is null, an instance of NullPointerException shall be thrown. 

CRRP5: If respOffset plus respLength is greater than the length of the array resp. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no read is performed. 

CRRP6: If fileOffset plus respLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 



5.3.1.8.1.3 



Context errors 



CRRCl: If the method call causes an error to occur that is not expected and thus not handled, an instace of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 
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• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for the reading 
of an deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DAT_INVALIDATED. 

• CRRC5:If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 



5.3.1.8.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Afv_Redb.java. 
Api_4_Afv_Redb_ 1 .j ava. 
Api_4_Afv_redb.cap. 



5.3.1.8.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


1,2 


P1 


3 


P2 


6 


P3 


7 


P4 


5 


P5 


8 


P6 


4 


C1 


Not testable 


C2 


9 


C3 


10 


C4 


11 


C5 


12 



5.3.1.8.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Read from EFtaru 

1- select DFtest, fid=llll 
select EFtaru, fid=6F03 

2- fileOffset = 
resp. length = 260 
resp [0:259] = 0x55 
respOffset = 10 
respLength = 25 
readBinary { ) 


2 - shall return 20. 

resp shall contain the contents of 

EFtaru Starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF FF .. .. FF> 




2 


Read from EFtaru 

fileOffset = 0x80 
resp. length = 260 
resp [0:259] = 0x55 
respOffset = 5 
respLength = 0x8 
readBinary { ) 


shall return 15 

resp shall contain the last 5 bytes of 

EFtaru Starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF ... 55 55 .. .. 55 FF FF 

... FF> 




3 


FileOffset is negative 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




4 


FileOffset + respLength > EF length 

fileOffset = 259 
respOffset = 
respLength = 2 
readBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 





ETSI 



Release 6 



466 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


5 


resp[] is null 

fileOffset = 
resp = null 
respOffset = 
respLength = 10 
readBinary { ) 


Shall throw 
java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExceptlon. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExceptlon. 




8 


RespOffset + respLength > resp.length 

fileOffset = 
resp.length =20 
respOffset = 10 
respLength = 11 
readBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExceptlon. 




9 


EF is not Transparent 

1- select EFlaru, fid=6F0C 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary { ) 


2 - Shall throw ulcc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 




10 


Access condition not fulfilled 

1- select EFtrac, fid=6F0E 

2- fileOffset = 
respOffset = 
respLength = 1 
readBinary { ) 


2- Shall throw uicc.access.UICC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 




11 


EF is deactivated 

1 - select EFtaru, fid=6F03 

2 - deactivateFile {) 

3 - readBinary {) 

4 - activateFile {) ) 


3 - Shall throw 

uicc.access.UICCException with 
reason code 
REF_DATA_INVALIDATED. 




12 


No EF selected 

1- select DFtest f id=llll 
2 readBinary {) 


2 - Shall throw 

uicc.access.UICCException with 
reason code NO EF SELECTED. 





5.3.1.9 Method updateBinary 

Test Area Reference: Api_4_Afv_Updb. 

5.3.1.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void updateBinary {short fileOffset, 

byte [] data, 
short dataOffset, 
short dataLength) 
throws Java. lang.NullPointerException, 

Java. lang. ArraylndexOutOfBoundsExceptlon, 
UICCException 

5.3.1 .9.1 .1 Normal execution 

• CRRNl : Updated the data bytes of the current selected transparent EF. 
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5.3.1.9.1.2 



Parameter errors 



CRRPl: If recOffset is less than 0, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.OUT_OF_FILE_BOUND ARIES. 

CRRP2: : If fileOffset plus dataLength exceeds the length of the file, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 



5.3.1.9.1.3 



Context errors 



CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

CRRC2: If the currently selected EF is not transparent, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating of 
a deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.9.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Te s t_ Api_4_ Af v_Updb .j a va . 
Api_4_Afv_Updb _Ljava. 
Api_4_Afv_updb.cap. 



5.3.1.9.3 



Test coverage 



CRR number 


Test case number 


N1 


2,3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


CI 


1 


C2 


10 


C3 


11 


C4 


12 


C5, 


Not Testable 


C6 


Not Testable 
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5.3.1.9.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get the UICC FlleView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR ON RESET) 







1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
NO_EF_SELECTED. 


1 


2 


Update Transparent EF 

1- select DFtest, fid = 1111 

2- select EFtaru, fid = 6F03 

3- fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 

4- fileOffset = 3 
respOffset = 
respLength = 1 
readBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


fileOffset = 254 

1- fileOffset = 254 
data[0] = '55' 
data[l] = 'AA' 
data [2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary { ) 

2- fileOffset = 254 
respOffset = 
respLength = 3 
readBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1] = 'AA' 
resp[2] = '66' 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength =10 
updateBinary { ) 


Shall throw 

uicc.access.UICCException with 
reason code 
OUT OF FILE BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary { ) 


Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte[] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary { ) 


Shall throw 
java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 
dataOffset = -1 
dataLength =10 
updateBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


EF is not Transparent 

1- select DFtest, fid = 1111 

2- select DFlseu, fid = 6F0C 
3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uicc.access.UICC 
Exception with reason code 
COMMANDJNCOMPATIBLE. 




11 


Access condition not fulfilled 

1- select DFtest, fid = 1111 

2- select EFthd, fid = 6F02 

3- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw 

uicc.access.UICCException with 
reason code 

SECURITY STATUS NOT SATISFIE 
D. 




12 


EF is deactivated 

1- select EFtne, fid = GFOl 
deactiveFile { ) 

2- fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 

3- activateFile {) 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with 
reason code 
REF_DATA_INVALIDATED 

3- No exception shall be thrown. 





5.3.1.10 Method read Record 

Test Area Reference: Api_4_Afv_Redr. 

5.3.1 .1 0.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short readRecord {short recNumber, 

byte mode, 
short recOffset, 
byte [] resp, 
short respOffset, 
short respLength) 
throws Java . lang. Null Point erExcept ion, 

Java . lang. ArraylndexOutOfBoundsExcept ion, 
UICCException 



5.3.1.10.1.1 



Normal execution 



CRRNl: Reads a record or a part of record of a current linear fixed or cyclic EF into byte array resp and the 
sum of respOffset plus respLength is returned. 

CRRN2: If the access mode is REC_ACC_MODE_CURRENT the current record will be read and the current 
record pointer shall not be changed. 

CRRN3: If the access mode is REC_ACC_MODE_ ABSOLUTE the record addressed by recNumber will be 
read and the current record pointer shall not be changed. 

CRRN4: If the access mode is REC_ACC_MODE_NEXT the next record relative to the current selected 
record will be selected and read. The record pointer will be incremented. 

CRRN5: If the access mode is REC_ACC_MODE_NEXT and no current record is selected, the first record 
will be selected and read. The record pointer will be incremented. 

CRRN6: If the access mode is REC_ACC_MODE NEXT and the current record pointer, of a cyclic EF, is set 
to the last record, the record pointer is set to the first record and the record is read. 

CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and read. 
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• CRRN8: If the access mode is REC_ACC_MODE PREVIOUS and no current record is selected, the last 
record will be selected and read. 

• CRRN9:If the access mode is REC_ACC_MODE_PREVIOUS and the current record pointer of a cycUc EF is 
set to the first record, the record pointer is set to the last record in this EF and this record shall be read. 

• CRRNIO: The current record pointer of any other applet shall not be changed. 

5.3.1.10.1.2 Parameter errors 

• CRRPl : If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException.RECORD_ NOT_FOUND. 

• CRRP4: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.RECORD_ NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus respLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICC Exception.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 (2 = REC_ACC_MODE_NEXT, etc.), an instance of 
UICCException shall be thrown. The reason code shall be UICC Exception.INVALID_MODE. 

• CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If respOffset plus respLength is greater than the length of the array resp.length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

5.3.1.10.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 



• 



• 



CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.3.1.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.10.3 



Test area files 

Test_Api_4_Afv_Redr.j ava. 
Api_4_Afv_Rredr_l .Java. 
Api_4_Afv_redr.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6,8,9, 10, 11, 12, 13 


N2 


3,9 


N3 


2,8 


N4 


4,5, 10, 11 


N5 


4, 11 


N6 


11 


N7 


6, 7, 12, 13 


N8 


6, 13 


N9 


12 


N10 




P1 


14 


P2 


15 


P3 


5 


P4 


7 


P5 


16 


P6 


17 


P7 


18 


P8 


19 


P9 


20 


P10 


21 


P11 


22 


C1 


1 


C2 


23 


C3 


24 


C4 


25 


C5 


Not testable 



5.3.1.10.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFtest, fid=llll 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] resp = new byte [20] 

respOffset = 

respLength = 10 

readRecord { ) 


2 -Shall throw 

uicc.access .UICCException with 

reason code NO_EF_SELECTED. 




2 


Read Absolute from Linear Fixed EF 

1 - select EFlaed, fid=6F0c 
// Record pointer not set. 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 


2 - resp shall be: 
resp={OxAA, OxAA, OxAA, OxAA} 

3- resp shall be: 

Resp= { 0x55 , 0x55 , 0x55 , 0x55 } 





£75/ 



Release 6 



472 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API Expectation 


APDU Expectation 


3 


Read Current from Linear Fixed EF 

//record pointer shall not be changed 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 


resp shall be: 

resp={0x55, 0x55, 0x55, 0x55} 




4 


Read Next from Linear Fixed EF 

1- select EFlaru, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

2- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 


1- resp shall be: 
resp={0x55, 0x55, 0x55, 0x55} 

2- resp shall be: 
resp={OxAA, OxAA, OxAA, OxAA} 




5 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 


Shall throw uicc .access .UICC 
Exception with reason code 
RECORD_NOT_FOUND . 




6 


Read Previous from Linear Fixed EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

2- select EFlaru, fid=6F0c 
//no record selected 
recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 

3- Set the record to the first record 
by reading the file 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 


1- resp shall be: 
resp={0x55, 0x55, 0x55, 0x55} 

2- resp shall be: 
resp={OxAA, OxAA, OxAA, OxAA} 

3- resp={0x55, 0x55, 0x55, 0x55} 




7 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord { ) 


Shall throw 

uicc .access .UICCException with 

reason code RECORD _NOT_FOUND. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Read Absolute from Cyclic EF 

1 select EFcAHu, fid = 6F09 
2- recNumber = 2 
mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 


2 - resp shall be: 
resp={OxAA, OxAA, OxAA} 






respOffset = 
respLength = 3 
readRecord { ) 
3- recNumber = 1 
readRecord { ) 


3 - resp shall be: 
resp= { OxAA, OxAA, OxAA} 






4- Read the file in next mode to set the 
record pointer to the first position. 


4 - resp shall be: 
resp={OxAA, OxAA, OxAA} 






recNumber = 








mode = REC ACC MODE NEXT 








recOffset = 








respOffset = 
respLength = 3 
readRecord { ) 






9 


Read Current from Cyclic EF 

//record pointer shall not be changed 

//from testcase before 

1- recNumber = 

mode = REC_ACC_MODE_CURRENT 

recOffset = 

respOffset = 

respLength = 3 

readRecord { ) 


1- resp shall be: 
resp={OxAA, OxAA, OxAA} 




10 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 


resp shall be: 
resp={OxAA, OxAA, OxAA} 




11 


Read Next from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 


1- resp shall be: 
resp={0x55, 0x55, 0x55} 






respOffset = 

respLength = 3 

readRecord { ) 

2- select EFcarh, fid = 6F09 

//no rec selected 

recNumber = 


2- Shall throw 

uicc .access .UICCException with 

reason code RECORD NOT FOUND. 






mode = REC ACC MODE NEXT 








recOffset = 








respOffset = 
respLength = 3 
readRecord { ) 






12 


Read Previous from Cyclic EF 

1- recNumber = 








mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 


1- resp shall be: 
resp={OxAA, OxAA, OxAA} 






respLength = 3 
readRecord { ) 






13 


Read Previous from Cyclic EF 

1- recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 








respOffset = 
respLength = 3 
readRecord { ) 


1- resp shall be: 
resp= { 0x55 , 0x55 , 0x55 } 






2- select EFcaru, fid = 6F09 








// no rec selected 








recNumber = 








mode = REC ACC MODE PREVIOUS 








recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 


2- resp shall be: 
resp={OxAA, OxAA, OxAA} 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Read Absolute from Linear Fixed EF beyond 
Records 

1- select EFlaru, fid=6F0C 

2- recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 


2- Shall throw an 

uicc .access .UICCException with 

reason code 

UICCException . RECORD_NOT_FOUND . 






respOffset = 
respLength = 4 
readRecord { ) 
3- recNumber = 3 
readRecord { ) 


3- Shall throw an 

uicc.access .UICCException with 

reason code 

UICCException . RECORD_NOT_FOUND . 




15 


No current record in linear fixed EF, read 
current 

1- select EFlaru, fid=6F0C // No current 








record 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE_CURRENT 
recOffset = 


2 - Shall throw uicc .access .UICC 
Exception with reason code 
REC0RD_N0T_F0UND . 






respOffset = 
respLength = 4 
readRecord { ) 






16 


recOffset < 








1- select EFlaru, fid=6F0C 

2- recNumber =1 // rec 1 


2 - Shall throw 






mode = REC ACC MODE ABSOLUTE 


uicc .access .UICCException with 






recOffset = -1 
respOffset = 


reason code 
0UT_0F_REC0RD_B0UNDARIES . 






respLength = 4 
readRecord { ) 






17 


recOffset + respLength > Record Length 

1- select EFlaru, fid=6F0C 








2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 2 

respOffset = 

respLength = 4 

readRecord { ) 


2 - Shall throw 

sim. access . SIMViewException with 
reason code 
0UT_0F_REC0RD_B0UNDARIES . 




18 


Reading with invalid mode 








1- select EFlaru, fid=6F0C 

2- recNumber = 


2 - Shall throw 






mode = 1 


uicc .access .UICCException with 






recOffset = 
respOffset = 
respLength = 4 
readRecord { ) 
3- mode = 5 


reason code 
C0MMAND_INC0MPATIBLE . 
3 - Shall throw uicc.access. 
UICCException with reason code 
COMMAND INCOMPATIBLE. 






readRecord { ) 






19 


resp is null 

resp[] = null 

mode = REC_ACC_MODE_CURRENT 

respOffset = 

respLength = 10 

readRecord { ) 


Shall throw 

Java. lang. Null Point erExcept ion. 




20 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord { ) 


Shall throw 

Java. lang.ArraylndexOutOf BoundsE 

xception. 




21 


respLength < 

respOffset = 
respLength = -1 
readRecord {) 


Shall throw 

Java. lang. 

ArraylndexOutOf BoundsException. 




22 


respOffset + respLength > resp.length 

respOffset = 11 
respLength = 4 
readRecord {) 


Shall throw 

Java. lang. 

ArraylndexOutOf BoundsException. 




23 


EF is neither Cyclic nor Linear Fixed 

1- select EFtku, fid=6F02 

2- respOffset = 
respLength = 4 
readRecord { ) 


2 - Shall throw 

uicc .access .UICCException with 

reason code 

COMMAND INCOMPATIBLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


24 


Access condition not fulfilled 

1- select EFcKE, fid=eF04 
2 - respLength = 3 
readRecord { ) 


2 - Shall throw 

uicc .access .UICCException with 

reason code 

SECURITY STATUS NOT SATISFIED. 




25 


EF is deactivated 

1 - select EFcKD, fid=6F05 
deactivateFile { ) 

2 - readRecord { ) 

3 - activateFile 


2 - Shall throw uicc .access .UICC 
Exception with reason code 
REF_DATA_INVALIDATED 





5.3.1 .1 1 Method updateRecord 

Test Area Reference: Api_4_Afv_Updr. 

5.3.1 .1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void updateRecord {short recNumber, 

byte mode, 
short recOffset, 
byte [] data, 
short dataOffset, 
short dataLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 

5.3.1.11.1.1 Normal execution 

• CRRN 1 : Reads a record or a part of record of the current linear fixed or cyclic EF into byte array data[] . 

• CRRN2: If the access mode is REC_ACC_MODE_ CURRENT the current selected record will be updated. 
The current record pointer shall not be changed. 

• CRRN3:If the access mode is REC_ACC_MODE_ ABSOLUTE and the file is Unear fixed EF, the record 
addresss by recNumber will be updated. The current record pointer shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF the next record 
relative to the current selected record will be selected and updated. The record pointer shall be updated. 

• CRRN5: If the access mode is REC_ACC_MODE_NEXT and the record pointer has not been previously set 
within the selected EF, the record pointer shall be set to the first record and this record should be updated. 

• CRRN6: If the access mode is REC_ACC_MODE_PREVIOUS the previous record relative to the current 
selected record will be selected and updated. The record pointer shall be updated. 

• CRRN7: If the access mode is REC_ACC_MODE_PREVIOUS and the record pointer has not been previously 
set within the selected EF, then the record pointer should be set to the last record in this EF. This record should 
be updated. 

• CRRN8: If the access mode is REC_ACC_MODE_PREVIOUS, the file is a cyclic EF, the oldest record will 
be updated independent of the current record pointer and this record becomes record number 1 and the current 
record. 
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5.3.1.11.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_ABSOLUTE 
and recNumber is less than or greater than records available, an instance of UICCException shall be thrown. 
The reason code shall be UICCException.RECORD_NOT_FOUND. 

• CRRP2: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE .CURRENT, 
recNumber is and there is no current record selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of UICCException shall be thrown. The reason code 
shall be UICCException. RECORD_NOT_FOUND. 

• CRRP4: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_PREVIOUS 
and the current record pointer is set to the first record; an instance of UICCException shall be thrown. The 
reason code shall be UICCException. RECORD_NOT_FOUND. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus dataLength is greater than the record length, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.OUT_OF_RECORD_BOUNDARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an 
instance of UICCException shall be thrown. The reason code shall be UICCException.INVALID_MODE. 

• CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 
REC_ACC_MODE_PREVIOUS, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE. 

• CRRP9: If the array data is null, an instance of NullPointerException shall be thrown. 

• CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

5.3.1.11.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMANDJNCOMPATIBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be UICCException. 
SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for updating an 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be UICCException. 
REF_DATA_INVALIDATED. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.3.1.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.11.3 



Test area files 

Test_Api_4_Afv_Updr.j ava. 
Api_4_Afv_ Updr_l.java. 
Api_4_ Af v_updr . c ap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3,4,5,7,8, 10 


N2 


2 


N3 


3 


N4 


5 


N5 


4 


N6 


7,8,9, 10 


N7 


7 


N8 


10 


P1 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5 


Not testable 


C6 


Not testable 
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5.3.1.11.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Get tlie UICC AdminFileView 

AdminFileViewBuilder . getTheUICCAdminFil 
eView {CLEAR ON RESET) 






1 


No EF selected 

RecNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

byte[] data = new byte [20] 

dataOffset = 

dataLength = 10 

updateRecord { ) 


Shall throw uicc.access.UICC Exception 
with reason code NO_EF_SELECTED. 




2 


Update Absolute from Linear Fixed EF 

1- select DFtest, fid = 1111 

2- select EFlseu, fid = SFOC 
// Record pointer not set. 

3- recNumber = 2 

mode = REC_ACC_M0DE_ABS0LUTE 

data [0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord { ) 

respOffset = 

respLength = 

readRecord { ) 

4- // verify result 
read respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_CURRENT 
readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 
4- Resp shall be: 1 1 111111 




3 


Update Current from Linear Fixed EF 

1- select DFtest, fid = 1111 

2- select EFlard, fid = 6F0C 

// Set record pointer with mode "next" . 

3- recNumber = 

mode = REC_ACC_M0DE_NEXT 

recOffset = 

data [0:3] = '00' 

dataOffset = 

dataLength = 4 

updateRecord { ) 

// write data with mode "current" 

4- recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODECURRENT 
updateRecord { ) 

5- //verify result 
respOffset = 
respLength = 4 
recNumber = 

mode = REC_ACC_MODE_ CURRENT 
readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

5- No exception shall be thrown. 

resp shall be: 

resp[0] = '22' 

resp[1] = '22' 

resp[2] = '22' 

resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no 
record pointer set 

1- select DFtest, fid = 1111 

2- select EFlaru, fid = 6F0C 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 

data[0:3] = '33' 

dataOffset = respOffset = 

dataLength = respLength = 4 

updateRecord { ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

4-// verify result 

readRecord { ) 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 

4- No exception shall be thrown. 

resp shall be: 

resp[0] = '33' 

resp[1] = '33' 

resp[2] = '33' 

resp[3] = '33' 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Update Next from Linear Fixed EF, record 








pointer set 


1- No exception shall be thrown. 






1- recNumber = 








mode = REC_ACC_MODE_NEXT 








recOffset = 








data [0:3] = '44' 
dataOffset = 


2- No exception shall be thrown. 






dataLength = 4 


resp shall be: 






updateRecord { ) 


resp[0] = '44' 






2- //verify result 


resp[1 ] = '44' 






readRecord { ) 


resp[2] = '44' 
resp[3] = '44' 




6 


Update Next from Linear Fixed EF, no more 
records 








recNumber = 


Shall throw uicc.access.UICCException 






mode = REC_ACC_MODE_NEXT 


with reason code 






recOffset = 


RECORD_NOT_FOUND. 






data [0:3] = '55' 








dataOffset = 








dataLengtli = 4 








updateRecord { ) 






7 


Update Previous from Linear Fixed EF, no 
record pointer set 








1- select DFtest, fid = 1111 


1- No exception shall be thrown. 






2- select EFlsru, fid = 6F0C 


2- No exception shall be thrown. 






3- recNumber = 


3- No exception shall be thrown. 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 








data [0:3] = '66' 








dataOffset = respOffset = 








dataLengtli = respLengtli = 4 


4- No exception shall be thrown. 






updateRecord { ) 


resp shall be: 






4- //verify result 


resp[0] = '66' 






readRecord { ) 


resp[1] = '66' 
resp[2] = '66' 
resp[3] = '66' 




8 


Update Previous from Linear Fixed EF, 
record pointer set 








1- recNumber = 


1- No exception shall be thrown 






mode = REC_ACC_MODE_PREVIOUS 








recOffset = 
data [0:3] = '77' 


2- No exception shall be thrown. 






dataOffset = respOffset = 


esp shall be: 






dataLengtli = respLength = 4 


resp[0] = '77' 






updateRecord { ) 


resp[1] = '77' 






2- //verify result 


resp[2] = '77' 






readRecord { ) 


resp[3] = '77' 




9 


Update Previous from Linear Fixed EF , no 
more records 








recNumber = 


Shall throw 






mode = REC_ACC_MODE_PREVIOUS 


sim. access. SIMViewException with 






recOffset = 


reason code RECORD_NOT_FOUND. 






data [0:3] = '88' 








dataOffset = respOffset = 








dataLengtli = respLengtli = 4 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Update Previous from Cyclic EF 

1- select DFtest, fid = 1111 

2- select EFcaru, fid = 6F09 

3- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 
respOffset = 
respLength = 3 
readRecord { ) 

4- recNumber = 2 

mode = REC ACC MODE PREVIOUS 
data[0:2] = ' FF ' 
dataOffset = 
dataLength = 3 
updateRecord { ) 

5- //verify result 
readRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- No exception shall be thrown. 

4- No exception shall be thrown. 

5- No exception shall be thrown, 
resp shall be: 

resp[0] = 'FF'resp[1] = 'FF' 
resp[21 = 'FF' 




11 


Update Absolute from Linear Fixed EF 
beyond Records 

1- select EFlaru, fid = 6F0C 

2 -recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord { ) 

3- recNumber = 3 

updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 

3- Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




12 


No current record in linear fixed EF, update 
current 

1- select EFlaru, fid = 6F0C 
// No curr rec 

2- recNumber =0 // curr rec 
mode = REC_ACC_MODE _CURRENT 
recOffset = 

dataOffset = 
dataLength = 4 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - Shall throw 

uicc.access.UICCException with reason 
code RECORD_NOT_FOUND. 




13 


recOffset < 

1- select EFlaru, fid = 6F0C 

2- recNumber =1 // rec 1 
mode = REC_ACC_MODE_ABSOLUTE 
dataOffset = 
dataLength = 4 
updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




14 


recOffset + dataLength > record.length 

1- select EFlaru, fid = 6F0C 

2- recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE 
recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access.UICC 
Exception with reason code 
OUT_OF_RECORD_BOUNDARIES. 




15 


Updating with invalid mode 

1- select EFlaru, fid = 6F0C 

2- recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord { ) 

3- mode = 5 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - Shall throw uicc.access.UICC 
Exception with reason code 
INVALID_MODE. 

3 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID MODE. 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Updating Cyclic EF with invalid mode 

1- select DFtest, fid = 1111 

2- select EFcaru, fid = 6F09 

set record pointer to record nr 1 

3- recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord { ) 

4- recNumber = 

mode = REC_ACC_MODE_ABSOLUTE 
updateRecord { ) 

5- recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID_MODE. 

4 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID_MODE. 

5 - Shall throw uicc.access. UlCC 
Exception with reason code 
INVALID MODE. 




17 


data[] is null 

data[] = null 
dataOffset = 
dataLength = 10 
updateRecord { ) 


Shall throw 
java.lang.NullPointerException. 




18 


dataOffset < 

dataOffset = -1 
dataLength = 10 
updateRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


dataLength < 

dataOffset = 
dataLength = -1 
updateRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1- select DFtest, fid = 1111 

2- select EFtaru, fid = 6F03 

3- dataOffset = 
dataLength = 4 
updateRecord { ) 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall throw uii. access. UlCC 
Exception with reason code 
COMMAND INCOMPATIBLE. 




22 


Access condition not fulfilled 

1- select EFcHu, fid = SFOS 

2- recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord { ) 

3- fid = EFLNU 
select { ) 

4- recNumber = 1 

mode = REC_ACC_MODE_ CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord { ) 


1- No exception shall be thrown. 

2- Shall throw uicc.access. UlCC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D. 

3- No exception shall be thrown. 

4- Shall throw uicc.access. UlCC 
Exception with reason code 
SECURITY STATUS NOT SATISFIE 
D 




23 


EF is deactivated 

1- select EFcHR, fid = 6F04 
invalidate { ) 

2- updateRecord { ) 

3- activateFile {) 

4- restore the file content EFlaeu, EFcaru 

Restore the file content 

1- restore the file content of EFlaru: 
record 1 = 0x55,0x55,0x55,0x55 
record 2 = OxAA, OxAA, OxAA, OxAA 

2- restore the file content of EFcaru: 
record 1 = 0x55,0x55,0x55 

record 2 = OxAA, OxAA, OxAA 


1- No exception shall be thrown. 

2- Shall throw 

uicc.access.UICCException with reason 
codeREF_DATA_INVALIDATED 

3- No exception shall be thrown. 





£75/ 



Release 6 482 ETSI TS 1 02 268 V6.1 .0 (201 3-06) 

5.3.1.12 Method search Record 

Test Area Reference: Api_4_Afv_Sear. 

5.3.1.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short searchRecord {byte mode, 

short recordNum, 
short searchlndication, 
byte [] patt , 
short pattOffset, 
short pattLength, 
short [] response, 
short respOffset, 
short respLength) 
throws Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 

5.3.1.12.1.1 Normal execution 

• CRRNl : Search a given pattern in byte array patt[] of a current linear fixed or cyclic EF. 

• CRRN2: If the pattern is found, the number of each record is stored in byte array response[] and the total 
number of updated bytes in the array response [] buffer is returned. 

• CRRN3: If the value of respLength is greater than the number of records found, the whole response is copied 
into the response buffer and the number of elements copied is returned by the method. 

• CRRN4: If the value of respLength is smaller than the number of found patterns, the first record numbers are 
copied into the response array and the value of respLength is returned. 

• CRRN5: If mode is SIMPLE_SEARCH_START_FORWARD, the search starts at the given record number 
forward towards the end of the file. 

• CRRN6: If mode is SIMPLE_SEARCH _START_BACKWARD, the search starts at a given record number 
backward towards to the beginning of the file. 

• CRRN7: If mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS is set in searchlndication, the search 
is backward starting from previous record towards to the beginning of the file. 

• CRRN8 : If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_BACKWARD_FROM_PREVIOUS_GR is set in searchlndication, the 
search is backward starting at a given record from previous record towards to the beginning of the file. 

• CRRN9: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_START_FORWARD_FROM_NEXT is set in searchlndication, the search is 
forward starting at the next record towards the end of the file. 

• CRRN 1 0: If the mode is ENHANCED_SEARCH and 
SEARCH_INDICATION_FORWARD_FROM_NEXT_GR is set in searchlndication, the search is forward 
starting at a given record number towards to the end of the file. 

• CRRN 1 1 : If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is not set, the search starts in the record from the offset (absolute position) given in the less 
significant byte of searchlndication. 

• CRRN12: If the mode is ENHANCED_SEARCH, and bit 4 of the most significant byte of the 
searchlndication is set, the search starts in the record after the first occurrence of the value contained in the less 
significant byte of searchlndication. 

• CRRN 13: If pattern given in patt[] is not found, the method returns 0. 
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• CRRN14: If one or more matches are found the record pointer shall be set to the first record where the search 
pattern was found. 

5.3.1.12.1.2 Parameter errors 

• CRRPl : If mode is not 4, 5 or 6, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.INVALID_MODE. 

• CRRP2: If the pattern array patt is null, an instance of java.lang.NullPointerException shall be thrown. 

• CRRP3: If the response array response is null, an instance of java.lang.NullPointerExceptino shall be thrown. 

• CRRP4: If parameter pattOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP5: If parameter pattLength is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP6: If parameter respOffset is negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP7: If parameter respLength negative, an instance of java.lang.ArraylndexOutOfBoundsException shall 
be thrown. 

• CRRP8: If parameter pattOffset plus pattLength are greater than the length of array patt, an instance of 
java.lang.ArraylndexOutOfBoundsException shall be thrown. 

• CRRP9: If parameter respOffset plus respLength are greater than the length of array response a 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If parameter recordNum is negative, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.RECORD_NOT_FOUND. 

• CRRPl 1 : If parameter recordNum is greather than, the total number of records from the currently selected EF, 
an instance of UICCException shall be thrown. The reason code shall be 
UICCException.RECORD_NOT_FOUND. 

• CRRPl 2 If pattLength is greater than record size of the currently selected EF an instance of UICCException 
shall be thrown. The reason code shall be UICCException.OUT_OF_FILE_BOUND ARIES. 

5.3.1.12.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not linear fixed or cyclic, an instance of UICCException shall be 
thrown. The reason code shall be UICCException.COMMAND_INCOMPATIBLE. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC4: If the currently selected EF is deactivated and the file status of the EF does not allow for reading a 
deactivated file, an instance of UICCException shall be thrown. The reason code shall be 
UICCException.REF_DATA_INVALIDATED. 

• CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 
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5.3.1.12.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.12.3 



Test area files 

Test_Api_4_Afv_Sear.j ava. 
Api_4_Afv_Sear_l .Java. 
Api_4_ Af v_se ar . cap . 

Test coverage 



5.3.1.12.4 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 


33, 34, 35, 36, 37 


N2 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 11 , 28, 29, 30, 31 , 32, 


33, 34, 35, 36, 37 


N3 


2, 3, 4, 5, 6, 7, 8, 9, 1 0, 1 1 , 28, 29, 30, 31 , 32, 


33, 34, 35, 36, 37 


N4 


12 


N5 


2, 28 


N6 


3,29 


N7 


6, 7, 34, 35 


N8 


8, 9, 36, 37 


N9 


10, 11,30,31 


N10 


12, 13,32, 33 


N11 


6,8, 10, 12,30,32,34,36 


N12 


7, 9, 11, 13,31,33,35,37 


N13 


2, 3, 5,7,9, 11,28, 31 


N14 


6,7, 10, 11,30,31,34,35 


P1 


13 


P2 


14 


P3 


15 


P4 


16 


P5 


17 


P6 


18 


P7 


19 


P8 


20 


P9 


21 


P10 


22 


P11 


23 


P12 


24 


CI 


1 


C2 


25 


C3 


26 


C4 


27 


C5 


Not testable 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFtest, fid=llll 

2- searchRecord { ) 


2-shall throw uicc. access. UICC 
Exception with reason code 
NO EF SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Fixed linear EF, 
Simple mode search forward 

1- select EFlsea, fid=6FlA 

2- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt [] ={0x10,0x03, 0x04} 
pattOffset = 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

3- Simple mode search forward 
mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 2 

patt [] ={OxlO, 0x03, 0x04} 
pattOffset = 1 
pattLength = 2 
resp. length = 4 
respOffset = 1 
respLength = 3 
searchRecord { ) 


2- no exception shall be thrown 
Shall return 0. 

response shall be: 
response={0, 0,0,0} 

3- Shall return 2. 
response shall be: 
response={0, 2,4,0} 




3 


Simple mode, search backward 

1- mode = SIMPLE_SEARCH_START_BACKWARD 

recordNum = 1 

patt [] ={0x08, OxOA, OxOB} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 

2 -mode = SIMPLE_SEARCH_START_BACKWARD 

recordNum = 6 

patt [] ={0x08, 0x09, OxOA, OxOB } 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0} 

respOffset = 1 

respLength = 3 

searchRecord { ) 


1- shall return 0. 
response shall be: 
response={0, 0,0,0} 

2- shall return 3. 
response shall be: 
response={0,4,3,1} 




4 


Enhanced Mode, search backward from 

previous record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+ 0x0009 

recordNum = 

patt [] ={0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+0x0000 

recordNum = 

patt [] ={OxOC, OxOD, OxOE, OxOF, 0x01, 0x02} 

pattOffset = 

pattLength = 5 

response [] = {0,0, 0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 


1- shall return 1, 
response shall be: 
resp={3,0,0,0} 

2- shall return 1 
response shall be: 
response={0, 0,2,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Enhanced Mode, search backward from 
previous record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+ 0x0810 

recordNum = 

patt [] ={0x01, 0x02, 0x03, 0x04} 

pattOffset = 

pattLength = 3 

response [] = {0,0, 0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 

2- perform 3 readRecordO in next mode 
to set current pointer to pointer 5 

3- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
+0X080E 

recordNum = 

patt [] ={0x01, 0x02, 0x03, 0x04} 

pattOffset = 3 

pattLength = 1 

response [] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 


1- shall return 0, 
response shall be: 
resp={0,0,0,0} 

3- shall return 2 
response shall be: 
response={4, 2,0,0} 




6 


Enhanced Mode, search backward from 

previous given record, start from an offset in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0000 

recordNum = 1 
patt []={0x01, 0x02, 0x0 3} 
pattOffset = 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH INDICATION BACKWARD FROM_PREVIOUS 

_GR + 0x0 04 

recordNum = 6 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = 3 

response [] = {0,0, 0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 


1- shall return 1, 
response shall be: 
resp={1 ,0,0,0} 

2- shall return 4 
response shall be: 
response={5,4,3,2} 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Enhanced Mode, search backward from 

previous given record, start from a value in 

record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_BACKWARD_FROM_PREVIOUS 
_GR + 0x0 SOD 

recordNum = 1 
patt [] ={OxOE, OxOE, OxOE} 
pattOffset = 1 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH INDICATION BACKWARD FROM PREVIOUS 

_GR + OxOSOO 

recordNum = 6 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0} 

respOffset = 

respLength = 4 

searchRecord { ) 


1- shall return 1, 
response shall be: 
resp={1 ,0,0,0} 

2- shall return 
response shall be: 
response={0, 0,0,0} 




8 


Enhanced Mode, search forward from next 
record, start from an offset in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0003 

recordNum = 
patt [] ={OxOO, OxOA, OxOB} 
pattOffset = 1 
pattLength = 2 
response [] = {0,0,0} 
respOffset = 2 
respLength = 2 
searchRecord { ) 

2- Perform readRecordO in previous mode 

3- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0003 

recordNum = 
patt [] ={0x00, OxOA, OxOB} 
pattOffset = 1 
pattLength = 2 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 2 
response shall be: 
resp={0, 0,3,4} 

3- shall return 1 
response shall be: 
response={4, 0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Enhanced Mode, search forward from next 
record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0804 

recordNum = 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 1 
pattLength = 2 
response [] = {0,0, 0,0} 
respOffset = 2 
respLength = 2 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT + 
0x0801 

recordNum = 
patt []={0x01, 0x02, 0x0 3} 
pattOffset = 2 
pattLength = 1 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 0, 
response shall be: 
resp={0,0,0,0} 

2- shall return 2 
response shall be: 
response={5, 6,0,0} 




10 


Enhanced Mode, search forward from next 
given record, start from an offset In record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
0x0007 

recordNum = 1 
patt [] ={0x01, 0x02,0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 1 
respLength = 3 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOOOC 

recordNum = 3 
patt [] ={0x03, 0x02,0x01} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 3, 
response shall be: 
resp={0, 3,4,5} 

2- shall return 1 
response shall be: 
response={6, 0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Enhanced Mode, search forward from next 
given record, start from a value in record. 

1- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOSOD 

recordNum = 5 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0, 0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOSOC 

recordNum = 5 
patt []={0x01, 0x02, 0x0 3} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 0, 
response shall be: 
resp={0,0,0,0} 

2- shall return 1 
response shall be: 
response={5, 0,0,0} 




12 


Simple mode, total number of found patterns 
exceed response[] 

1- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt []={0x01, 0x02, 0x0 3} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 

2- mode = SIMPLE_SEARCH_START_FORWARD 
recordNum = 1 

patt []={0x01, 0x02, 0x0 3} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 4 
searchRecord { ) 


1- shall return 4 
response shall be: 
response={1,2,3,4} 

2- shall return 4 
response shall be: 
response={1,2,3,4,0} 




13 


Invalid mode 

mode = 0x14 {simple search forward with 

SFI) 

searchIndication= 

recordNum = 2 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 


shall throw an uicc.access.UICC 
Exception with reason code 
INVALID_MODE. 




14 


Pattern array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []= null 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 2 

searchRecord { ) 


shall throw an 
java.lang.NullPointerException. 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Response array is null 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = 1 

response [] = null 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an instance of 
java.lang.NullPointerException. 




16 


pattOffset<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = -1 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




17 


pattLength<0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = -1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




18 


respOffset <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = -1 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




29 


respLength <0 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = -1 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




20 


PattOffset + pattLength > patt[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 2 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 1 

respLength = 5 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


RespOffset + respLength > response[] 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 3 

respLength = 3 

searchRecord { ) 


shall throw an instance of 

java.lang.ArraylndexOutOfBoundsExc 

eption. 




22 


recordNum < 

mode = SIMPLE_SEARCH_START_FORWARD 

searchIndication= 

recordNum = -1 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall throw an uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND 




23 


RecordNum > total number of file records 

1- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 7 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 

2- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 1 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 


1- shall throw an uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND 

2- shall throw an uicc.access.UICC 
Exception with reason code 
RECORD_NOT_FOUND 




24 


pattlength > record length 

1- mode = SIMPLE_SEARCH_START_FORWARD 
searchIndication= 

recordNum = 3 

patt [16] ={0x55, 0x55,..., 0x55} 
pattOffset = 
pattLength = 16 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 

2- mode = ENHANCED_SEARCH 
searchIndication= 

SEARCH_INDICATION_FORWARD_FROM_NEXT_GR + 
OxOOOE 

recordNum = 3 
patt [] ={0x01, 0x02, 0x03} 
pattOffset = 
pattLength = 3 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 


1- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 

2- shall throw an 

uicc. access. UlCCException with 
reason code 
OUT_OF_FILE_BOUNDARIES. 
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Id 


Description 


API Expectation 


APDU Expectation 


25 


Wrong file structure 

1- select EFtdac, fid=6F0F 








2- searchRecorcJ { ) 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

COMMAND INCOMPATIBLE 




26 


Security status not satisfied 

1- select EFlkr, fid=6F0A 








2- searchRecord { ) 


2- shall throw an 

uicc. access. UlCCException with 

reason code 

SECURITY STATUS NOT SATISFI 

ED 




27 


File deactivated 

1- select EFlaru, fid=6F10 

2- deactivateFile EFmRu 








3- searchRecord { ) 

4- activateFile { ) 


3- shall throw an 

uicc. access. UlCCException with 

reason code DATA INVALIDATED 




28 


Cyclic EF, Simple mode search forward 

1- select EFcsEA, fid=6FlB 








2- mode = SIMPLE_SEARCH_START_FORWARD 

recordNum = 1 

patt [] ={0x10,0x03, 0x04} 

pattOffset = 


2- shall return 
response shall be: 
response={0,0,0,0,0} 






pattLength = 1 








response [] = {0,0,0,0,0} 








respOffset = 








respLength = 5 








searchRecord { ) 








3- mode = SIMPLE_SEARCH_START_FORWARD 








recordNum = 2 








patt [] ={OxlO, 0x03, 0x04} 
pattOffset = 1 


3- Shall return 3. 






pattLength = 2 


response shall be: 






response [] = {0,0,0,0,0} 
respOffset = 2 


response={0,0,2,4,1} 






respLength = 3 








searchRecord { ) 








4- updateRecord { ) in previous mode with 








value 








{0x03, 0x02, 0x01, 0x03, 0x02, 0x01, 0x03, 0x02 








, 0x01 , 0x03 , 0x02 , 0x01 , 0x03 , 0x02 , 0x01 } 








{new record 1 is set to previous record 

6) 

5- mode = SIMPLE_SEARCH_START_FORWARD 














recordNum = 2 








patt [] ={0x10,0x03, 0x04} 








pattOffset = 1 
pattLength = 2 


5- Shall return 3. 






response [] = {0,0,0,0,0} 


response shall be: 






respOffset = 2 
respLength = 3 


response={0,0,2,3,5} 






searchRecord { ) 






29 


Cyclic EF, Simple mode search backward 








mode = SIMPLE_SEARCH_START_BACKWARD 
recordNum = 3 
patt [] ={0x10, 0x03, 0x04} 
pattOffset = 1 


shall return 3 
response shall be: 
response={0,3,2,5,0} 






pattLength = 2 








response [] = {0,0,0,0,0} 








respOffset = 1 








respLength = 4 








searchRecord { ) 
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Id 


Description 


API Expectation 


APDU Expectation 


30 


Cyclic EF, Enhanced mode, search forward 

from next record, start from an offset in 

record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T + 0x0009 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 3 

searchRecord { ) 


shall return 3 
response shall be: 
response={0,0,4,5,6} 




31 


Cyclic EF, Enhanced mode, search forward 

from next record, start from a value in 

record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T + 0x0810 

recordNum = 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 

pattLength = 3 

response [] = {0,0,0,0,0} 

respOffset = 2 

respLength = 3 

searchRecord { ) 


shall return 
response shall be: 
response={0,0,0,0,0} 




32 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from an offset 

in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_FORWARD_FROM_NEX 

T_GR + 0x0 05 

recordNum = 3 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 

pattLength = 1 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall return 5 
response shall be: 
response={3,4,5,6,1} 




33 


Cyclic EF, Enhanced mode, search forward 

from next given record, start from a value in 

record 

1- mode = ENHANCED_MODE 
searchIndication= 

SEARCH_INDICATION START FORWARD FROM NEX 
T_GR + 0x0805 

recordNum = 6 
patt [] ={OxOE, OxOF, 0x0 0} 
pattOffset = 
pattLength = 2 
response [] = {0,0,0,0,0} 
respOffset = 
respLength = 5 
searchRecord { ) 

2- Restore EF initial state {record 1 
shall be assigned to the record that 
content is 

{0x01,0x02, 0x0 3, 0x04, 0x05,0x06,0x07, 0x08 
, 0x09, OxOA, OxOB, OxOC, OxOD, OxE, OxOF} ) 
using 5 updateRecord { ) in previous mode 


1- shall return 2 
response shall be: 
response={2,4,0,0,0} 
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Id 


Description 


API Expectation 


APDU Expectation 


34 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from 

an offset in record 

1- Set current record pointer to record 
6 using 5 readRecord { ) in next mode 

2- mode = ENHANCED_MODE 
searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 
EVIOUS + 0x0 03 

recordNum = 
patt [] ={0x02, 0x01, 0x0 0} 
pattOffset = 
pattLength = 2 
response [] = {0,0,0,0,0} 
respOffset = 3 
respLength = 2 
searchRecord { ) 


2- shall return 1 
response shall be: 
response={0,0,0,6,0} 




35 


Cyclic EF, Enhanced mode, search 

backward from previous record, start from a 

value in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS + 0x08 01 

recordNum = 

patt []={0x01, 0x02, 0x0 3} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall return 5 
response shall be: 
response={5,4,3,2,1} 




36 


Cyclic EF, Enhanced mode, search 

backward from given record, start from an 

offset in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS_GR + 0x0 03 

recordNum = 5 

patt [] ={0x02, 0x01, 0x00} 

pattOffset = 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 3 

respLength = 2 

searchRecord { ) 


shall return 1 
response shall be: 
response={0,0,0,6,0} 




37 


Cyclic EF, Enhanced mode, search 

backward from given record, start from a 

value in record 

mode = ENHANCED_MODE 

searchIndication= 

SEARCH_INDICATION_START_BACKWARD_FROM_PR 

EVIOUS + 0x0801 

recordNum = 3 

patt [] ={0x01, 0x02, 0x03} 

pattOffset = 1 

pattLength = 2 

response [] = {0,0,0,0,0} 

respOffset = 

respLength = 5 

searchRecord { ) 


shall return 5 
response shall be: 
response={3,2,1,5,4} 
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5.3.1.13 Method increase 

Test Area Reference: Api_4_Afv_Incr. 

5.3.1.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short increase {byte [] incr, 

short incrOffset, 
short incrLength, 
byte [] resp, 
short respOffset) 
throws Java . lang. Null Point erExcept ion, 

j ava . lang . ArraylndexOutOf BoundsException, 
UICCException 

5.3.1.13.1.1 Normal execution 

• CRRNl: This method increases the current cyclic EF record. 

• CRRN2: The response buffer will only contain the value of the increased record. 

5.3.1.13.1.2 Parameter errors 

• CRRPl : If the array incr is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP3: If incrOffset is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If incrLength is negative, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If respOffset is negative, an instance of ArraylndexOutOfBoundsExceptoin shall be thrown. 

• CRRP6: If incrOffset plus incrLength, is greater than the length of array incr, an instance of 
ArraylndexOutOfBoundsException shall be thrown and no increase is performed. 

• CRRP7: If respOffset is greater than the length of array resp, an instance of 
ArraylndexOutOfboundsException shall be thrown. 

• CRRP8: If the result of the addition is greater than the maximum value of the record (represented by all bytes 
set to 'FF'), an instance of UICCException shall be thrown. The reason code shall be 
UICCException.MAX_VALUE_REACHED. 

• CRRP9: If incrLength is greater than 127, and exception shall be thrown. 

5.3.1.13.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
UICCException. shall be thrown. The reason code shall be UICCException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 

• CRRC4: If file is not a cyclic one, an instance of the UICCException shall be thrown. The reason code shall be 
UICCException.COMMANDJNCOMPATIBLE. 

• CRRC5: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an 
instance of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOTSATISFIED. 
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• CRRC6: If the currently selected EF is invalidated, an instance of UICCException shall be thrown. The reason 
code shall be UICCException.REF_DATA_INVALIDATED. 

• CRRC7: If the currently selected cyclic EF has no record, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_RECORD_FOUND. 



5.3.1.13.2 

Test Source: 
Test Applet: 
Cap File: 



Test areafiles 

Test_Api_4_Afv_Incr.j ava. 
Api_4_Afv_Incr_ 1 .j ava. 
Api_4_Afv_incr.cap . 



5.3.1.13.3 



Test coverage 



5.3.1.13.4 



CRR number 


Test case number 


N1 


1,2, 3, 15 


N2 


2,3,15 


P1 


4 


P2 


9 


P3 


6 


P4 


5 


P5 


10 


P6 


7 


P7 


11 


P8 


8 


P9 


15 


C1 


1 


C2 


Not testable 


C3 


Not testable 


C4 


12 


C5 


13 


C6 


14 


C7 


Not testable 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No EF selected 

1- select DFtest f id=llll 

2- byte[] incr = new byte [4] 
byte[] resp = new byte [4] 
incrOffset = 
incrLength = 2 
respOffset = 

increase { ) 


2- An 

UICCException. NO_EF_SEL 

ECTED should be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


increase , verify response 

1- select EFcARu, fid=6F09 

set the record pointer with 

readRecord { ) in PREVIOUS mode 

2-//Set both record to 00 00 00 

mode = REC_ACC_iyiODE_PREVIOUS 

data[] = {0x00,0x00,0x00} 

recOffset = 

dataOffset = 

dataLength = 3 

updateRecord { ) //update Record 1 

updateRecord { ) //update Record 2 

3- incr[] = {0x00,0x00,0x01} 

incrOffset = 

incrLength = 3 

resp. length = 4 

respOffset = 

ret = 3 

increase {) 


3- resp[] = 
{0x00,0x00,0x01,0x00} 




3 


increase, verify file 

1- incr [] ={OxOO, 0x00, 0x00, 0x02} 
incrOffset = 1 

incrLength = 3 
resp. length = 4 
respOffset = 1 
increase { ) 

2- resp[] = {0x00,0x00,0x00,0x00} 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

resp. length =4 

respOffset = 

respLength = 3 

readRecord { ) 


1 - resp[] = 
{0x00,0x00,0x00,0x03} 

2- resp[] = 
{0x00,0x00,0x03,0x00} 




4 


incr[] is null 

incr[] = null 
incrOffset = 
incrLength = 1 
resp. length = 4 
respOffset = 

increaseO 


Shall throw 

java.lang.NullPointerExceptio 

n. 




5 


incrLength< 

incr.length = 4 
incrOffset = 
incrLength = -1 
resp. length = 4 
respOffset = 
increase { ) 


Shall throw 

java.lang. 

Array IndexOutOfBoundsExc 

eptlon. 




6 


incrOffset < 

incr.length = 4 
incrOffset = -1 
incrLength = 1 
resp. length = 4 
respOffset = 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

eptlon. 




7 


IncrOffset + incrLength > incr.length 

incr.length = 4 

incrOffset = 1 

incLength = 4resp. length = 4 

respOffset = 

increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Reach Maximum Value 

1- incr [0:3] = OxFF 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 
increase { ) 

2- //Set both record to FF FF FF 
mode = REC_ACC_MODE_PREVIOUS 
data[] = {OxFF, OxFF, OxFF } 
recOffset = 

dataOffset = 

dataLength = 3 

updateRecord { ) //update Record 1 

updateRecord { ) //update Record 2 

3- incr[] = {0x00,0x00,0x01} 
incrOffset = 
incrLength = 3 
resp.length = 4 
respOffset = 

increase { ) 


1- Shall throw 

uicc.access.UICCException 
with reason code 
MAX_VALUE_REACHED. 

2- Shall throw 

uicc.access.UICCException 
with reason code 
MAX_VALUE_REACHED. 




9 


resp[] is null 

incr. length = 4 
incrOffset = 
incrLength = 1 
resp[] = null 
respOffset = 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




10 


respOffset < 

incr. length = 4 
incrOffset = 
incrLength = 1 
resp.length = 4 
respOffset = -1 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




11 


respOffset + recordLength > resp.length 

incr. length = 4 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 2 
increase { ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsExc 

option. 




12 


EF is not Cyclic 

1- select EFtarh fid= 6F03 

2- incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase { ) 

3 - select EFlaru, fid=6F0C 

4 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase { ) 


2 - Shall throw 
uicc.access.UICCException 
with reason code 
COMMAND INCOMPATIBL 

E. 

4 - Shall throw 
uicc.access.UICCException 
with reason code 
COMMAND INCOMPATIBL 

E. 




13 


Access condition not fulfilled 

1- select EFcKic, fid=6F06 

2- incr.length= 3 
incrOffset = 
incrLength = 3 
resp.length = 3 
respOffset = 
increase { ) 


2 - Shall throw 
uicc.access.UICCException 
with reason code 
SECURITY STATUS NOT 
SATISFIED. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


EF is invalidated 

l-select EFcaru, fid=6F09 

2 - invalidate {) 

3 - incr.length= 3 
incrOffset = 
incrLength = 3 
resp. length = 3 
respOffset = 
increase { ) 

4 - rehabilitate {) 

5- Restore initial content of EFcaru 


3 - Shall throw 
uicc.access.UICCException 
with reason code 
REF_DATA_INVALIDATED 




15 


incrLength out of range 

1- Create an EF Cyclic with 1 record of 
Ox7F length, fid=0x2C7F 

2- Select EF Cyclic, fid=0x2C7F 

3- Set record to following value rec [0] 
= 0; rec [1.. 126] = OxFF with an update 
record. 

4- incr . length=128 
incrOffset = 1 
incrLength = 12 7 
resp. length = 255 
respOffset = 

Incr[] initialized to = {OxOO,... 

,0x00,0x01} 

respOffset = 

ret = Ox7F 

increase { ) 

5- incr . length=128 
incrOffset = 
incrLength = 128 
resp. length = 255 
respOffset = 

Incr[] initialized to 
respOffset = 
increase { ) 

6- Delete EF Cyclic with fid=0x2C7F 


4-resp[0..126] = 
{0x01,0x00,0x00,. ..,0x00} 

5- Shall throw an exception 





5.3.1 .14 Method deactivateFile 

Test Area Reference: Api_4_Afv_Dacf. 

5.3.1.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void deactivateFile { ) 

throws UICCException 

5.3.1.14.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be deactivated, as defined in TS 102 222 [7]. 

5.3.1.14.1.2 Parameter errors 
No requirements. 

5.3.1.14.1.3 Context errors 

• CRRCl: If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 



ETSI 



Release 6 



500 



ETSI TS 102 268 V6.1.0 (2013-06) 



• CCRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.14.3 



Test area files 

Test_Api_4_Afv_Dacf.j ava. 
Api_4_Afv_Dacf_l .Java. 
Api_4_Afv_dacf.cap. 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 


C2 


4 


C3 


Not testable 



5.3.1.14.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- select DFtest f id=llll 

2- call deactivateFile {) 


2- An UICCException 
NO_EF_SELECTED is 
thrown 




2 


Deactivate activated File 

0- Select root directory 

1- Select EFnicc f id=2FF0 

2- ReadBinary EFmcc 

3- Deactivate EFmcc 

4- ReadBinary EFmcc 


2- No Exception shall be 

thrown 

4- 

UlCCException.REF DATA 

INVALIDATED is thrown 




3 


Deactivate deactivated File 

1- deactivateFile EFmcc 

2- activateFile EFmcc 


1- No Exception shall be 
thrown 




4 


Access condition not fulfilled 

1- select DFtest fid=llll 

2- select EFlsda fid=6F15 

3- deactivateFile EFlsda 


3- An UICCException 
SECURITY STATUS NOT 
SATISFIED is thrown 





5.3.1 .15 Method activateFile 

Test Area Reference: Api_4_Afv_Actf. 

5.3.1 .1 5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void activateFile { ) 

throws UICCException 
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5.3.1.15.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be activated, as defined in TS 102 222 [7]. 

5.3.1.15.1.2 Parameter errors 
No requirements. 

5.3.1.15.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of UICCException shall be thrown. The 
reason code shall be UICCException. NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, activate, to perform this function, an instance 
of UICCException shall be thrown. The reason code shall be 
UICCException.SECURITY_STATUS_NOT_SATISFIED. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
UICCException shall be thrown. The reason code shall be UICCException.INTERNAL_ERROR. 



5.3.1.15.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.1.15.3 



Test area files 

Test_Api_4_Afv_Actf .j ava. 
Api_4_Afv_Actf_l .Java. 
Api_4_Afv_actf cap . 

Test coverage 



CRR number 


Test case number 


N1 


2,3 


CI 


1 


C2 


4 


C3 


Not testable 



5.3.1.15.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 





Test applet is installed with no access 
right on Application Pin2 






1 


No EF is selected 

1- Select DFtest f id=llll 

2- Call activateFileO 


2- A UICCException NO_EF_SELECTED is 
thrown 




2 


Activate deactivated File 

0- Select Root directory 

1- Select EFnicc f id=2FF0 

2- ReadBinary EFmcc 

3- Deactivate EFmcc 

4- ReadBinary EFmcc 

5 -ActivateFile EFmcc 
6- ReadBinary EFmcc 


2- No Exception shall be thrown 
4- 

UICCException.REF_DATA_INVALIDATED 
is thrown 
6- No Exception shall be thrown 




3 


Activate activated File 

ActiveFile EFmcc 


No Exception shall be thrown 




4 


Access condition not fulfilled 

1- Select DFtest fid=llll 

2- Select EFlma fid=6F15 

3- ActivateFile EFlsda 


3- A UICCException 

SECURITY_STATUS_NOT_SATISFIED is 
thrown 
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5.3.2 Class AdminFileViewBuilder 
5.3.2.1 Method getTheUICCAdminFileView 

Test Area Reference: Api_4_Afb_Gtafb. 

5.3.2.1.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static AdminFileView getTheUICCAdminFileView {byte event) 
throws javacard. framework. SystemException 

5.3.2.1 .1 .1 Normal execution 

CRRNl: returns a reference to class which implements the FileView interface on the UICC file system. 

CRRN2: return null if one of the javacard.framework. Applet. register(..) method has not previously invoked by 
the applet invoking this method or the filesystem server returns null. 

CRRN3: It is not possible to get access to files which are located under any ADF with this FileView. 

CRRN4: After a successful invocation of the method, the MF is the current selected file. 

CRRN5: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. This context can be transient or persistent depending on what was required by the 
Applet during the creation of the FileView object. 

5.3.2.1.1.2 Parameter errors 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 

5.3.2.1.1.3 Context errors 

• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException. ILLEGAL_TRANSIENT shall be thrown. 

5.3.2.1.2 Test area files 

Test Source: Test_ Api_4_Afb_Gtafb.java. 
Test Applet: Api_4_Afb_Gtafb_l.java. 

Cap File: Api_4_Afb_Gtafb.cap. 
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5.3.2.1.3 



Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


1 


N3 


2 


N4 


2 


N5 


3 


P1 


7 


C1 


5,6 
Testable only if available transient space is lower than 32767 


C2 


4 



5.3.2.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIethod returns null 

Install Appletl with full access rights on 
the UICC file system 








Invoke the method getTheUICCView before the 
javacard. framework. Applet . register { . . ) 


returns null 






method invocation 






2 


Normal execution 








1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getTheUICCView { ) with the 


No exception shall be thrown 






event JCSystem.NOT A TRANSIENT OBJECT 








and stores the result in a class variable 








FVl 


Current selected DF is the IVIF 






Appletl calls status {) command 








Select DFTest using FVl 








Select EFtaru using FVl 

Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








2- Envelope menu selection is sent to the 


2- Appletl is triggered 






UICC 


Current selected DF is DFjest 






Appletl calls FVl. status {) command 


UlCCException.FILE NOT FOU 






Appletl calls FVl . select {Ox7FFF) 


ND is thrown 






Invoke the method getTheUICCView { ) with the 


No exception shall be thrown 






event JCSystem. CLEAR ON RESET and stores the 








result in a class variable FV2 








Appletl calls FV2. status {) command 


Current selected DF the IVIF 






Select DFrest using FV2 








Select EFtaru Using FV2 








Read first 3 bytes using FV2 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








4 - Envelope menu selection is sent to the 


4- Appletl is triggered 






UICC 


Current selected DF is the IVIF 






Appletl calls status {) command 


UlCCException.FILE NOT FOU 






Appletl calls select {Ox7FFF) 


ND is thrown 

5- Appletl is selected 
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Id 


Description 


API Expectation 


APDU Expectation 




5- Select the Applet by AID 

Invoke the method in the method process {) 
getTheUICCViewO with the event 
JCSystem.CLEAR_ON_DESELECT and stores the 
result in a class variable 

Appletl calls status {) command 

Select DFTsist using FV3 
Select EFtaru using FV3 
Read first 3 bytes using FV3 

Select ADF2 by AID 

6- Select the Applet by AID 
Appletl calls status {) command 
Appletl calls select {Ox7FFF) 


No exception shall be thrown 

Current selected DF the MF 

Expected value is {FF FF FF} 

6- Appletl is selected 

Current selected DF is the MF 
UICCException.FILE_NOT_FOU 
ND is thrown 




3 


Fllevlew context Independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different {FVl != FV2 != FV3 ) 

3- Select DFTest/EFLAEu using FVl 

4- Select DFTest/EFcAEu using FV2 

5- Select DFTest/EFcAEu using FV3 

6- Read record number 1 using FVl {in 
absolute mode) 

7- Read record number 2 using FV2 {in 
absolute mode) 


1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- An exception is thrown 

6- Expected value is "55 55 55 
55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemExceptlon 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheUICCView { ) method 
with the event JCSystem. CLEAR ON DESELECT 


1- Appletl is triggered 

2- System Exception. 
ILLEGAL_TRANSIENT is thrown 




5 


NO_TRANSIENT_SPACESystemExceptlon 
with CLEAR_ON_RESET Fllevlew object 

1- Get the available transient memory space 
using method 

length=JCSystem.getAvailableMemory {MEMORY TY 
PE_TRANS I ENT_RESET ) 

2- If length < 32767, {test case could be 
performed) 

2.1- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_RESET) 

2.2- Applet calls method getTheUICCView { ) 
with event 

JCSystem . CLEAR_ON_RESET 

4- Reset 


1- No exception shall be thrown 

2.1- No exception shall be 
thrown 

2.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE System Exception 
with CLEAR_ON_DESELECT Fileview object 

1- Select the Applet by AID 

2- Get the available transient memory space 
using method 

length=JCSystem.getAvailableMemory {MEMORY TY 
PE_TRANSIENT_DESELECT) 

3- If length < 32767, {test case could be 
performed) 

3.1- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_DESELECT) 

3.2- Applet calls method getTheUICCView { ) 
with event 

JCSystem . CLEAR_ON_DESELECT 

4- Reset 


1- Appletl is selected 

2- No exception shall be thrown 

3.1- No exception shall be 
thrown 

3.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE System Exception 

Invoke the method getTheUICCView { ) with 
every event codes except 0,1,2 


1- 

SystemException.il 1 FGAL VAL 

UE is thrown 





5.3.2.2 Method getTheAdminFileView(javacard.framework.AID aid, byte event) 

Test Area Reference: Api_4_Afb_Gtafob. 

5.3.2.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static AdminFileView getTheAdminFileView{javacard. framework. AID aid, byte event) 
throws NullPointerException, 

j avacard . framework . SystemException 



5.3.2.2.1.1 



Normal execution 



CRRNl: returns a reference to class which implements the AdminFileView interface on an ADF file system 
defined by is AID. 

CRRN2: returns null if the ADF with the AID does not exist. 

CRRN3: returns null if one of the javacard. framework. Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

CRRN4: After a successful invocation of the method the ADF is the currently selected file. 

CRRN5: A separate and independent file context shall be associated with each and every AdminFileView 
object: the operation performed on files in a given AdminFileView object shall not affect the file context 
associated with any other AdminFileView object. This context can be transient or persistent depending on 
what was required by the Applet during the creation of the AdminFileView object. 

CRRN6: It is not possible to access files which are not located under the ADF. 
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5.3.2.2.1.2 



Parameter errors 



CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SysteniException.ILLEGAL_VALUE. 



CRRP2: If the AID is null a NullPointerException shall be thrown. 



5.3.2.2.1.3 



Context errors 



• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException.ILLEGAL_TRANSIENT shall be thrown. 



5.3.2.2.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_ Api_4_Afb_Gtafob.java. 

Api_4_Afb_Gtafob.java. 

Api_4_Afb_Gtafob.cap. 



5.3.2.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1 to 3 


N2 


1 


N3 


1 


N4 


2 


N5 


3 


N6 


2 


P1 


7 


P2 


8 


C1 


5,6 
Testable only if available transient space is lower than 32767 


02 


4 



5.3.2.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Method returns null 

1- Install Appletl with full access rights 
on the UICC file system 

2- Invoke the method getTheAdminFileView 
before the 

javacard. framework. Applet . register { . . ) 
method invocation 

3- Envelope menu selection is sent to the 
UICC 

4- Invoke the method getTheAdminFileView { ) 
with AID = unknown ADF AID 


2- returns null 

3- applet is triggered 

4- returns null 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Normal execution 

1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getTheAdminFileView { ) 

with AID = ADFl with the event 

JCSystem . NOT_A_TRANSIENT_OBJECT 

and stores the result in a class variable 

FVl 


No Exception sliall be thrown 






Appletl calls FVl. status {) command 


Current selected DF is ADF1 






Select DFTest using FVl Select EFTARU 
using FVlRead first 3 bytes using FVl 

Reset 

Terminal profile 


Expected value is {FF FF FF} 






2 - Envelope menu selection is sent to the 








UICC 


2- Appletl is triggered 






Appletl calls FVl. status {) command 
Read first 3 bytes using FVl 
Appletl calls FVl . select (EFRFUl) 


Current selected DF is DFjest 

Expected value Is {FF FF FF} 

UlCCExceptionUICCException.FIL 
E_NOT_FOUND is thrown 






Invoke the method getTheAdminFileView { ) 
with the event JCSystem. CLEAR_ON_RESET and 
stores the result in a class variable FV2 


No exception shall be thrown 






Appletl calls FV2. status {) command 


Current selected DF is the ADF1 






Select DFTest using FV2 
Select EFTARU using FV2 
Read first 3 bytes using FV2 

Reset 

Terminal profile 


Expected value Is {FF FF FF} 






4 - Envelope menu selection is sent to the 
UICC 


4- Appletl is triggered 






Appletl calls FV2. status {) command 


Current selected DF is the ADF1 






Read first 3 bytes using FV2 


UlCCException. 
NO_EF_SELECTED 






Appletl calls FV2 . select (EFRFUl) 


UICCException.FILE_NOT_FOUN 
D is thrown 






5- Select the Applet by AID 

Invoke the method getTheAdminFileView { ) 

with AID = ADFl with the event : 

JCSystem. CLEAR_ON_DESELECT and stores the 

result in a class variable FV3 


5- Appletl is selected 

No Exception shall be thrown 






Appletl calls FV3. status {) command 
Select DFTest using FV3 Select EFTARU 
using FV3 
Read first 3 bytes using FV3 


Current selected DF is ADF1 
Expected value is {FF FF FF} 






6- Select the Applet by AID 


6- Appletl is selected 






Appletl calls FV3. status {) command 


Current selected DF is ADF1 






Read first 3 bytes using FV3 


UlCCException. NO_EF_SELECTE 
D shall be thrown 
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Id 


Description 


API Expectation 


APDU Expectation 




Appletl calls FV3. select (EFRFUl) 


UICCException.FILE_NOT_FOUN 
D shall be thrown 




3 


FileVlew context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different {FVl != FV2 != FV3 ) 

3- Select DFTest/EFLARU using FVl 

4- Select DFTest/EFCARU using FV2 

5- Select DFTest/EFCARU using FV3 

6- Read record number 1 using FVl {in 
absolute mode) 

7- Read record number 2 using FV2 {in 
absolute mode) 


1- Appletl Is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- An exception shall be thrown 

6- Expected value Is "55 55 55 55" 

7- Expected value is "AA AA AA" 




4 


ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheAdminFileView{ ) 
method with the event 

JCSystem . CLEAR_ON_DESELECT 


1- Appletl is triggered 

2- SystemExceptlon. 
ILLEGAL_TRANSIENT is thrown 




5 


NO TRANSIENT SPACE SystemExceptlon 
with CLEAR_ON_RESET FlleView object 

1 Get the available transient memory 

space using method length = 

JCSystem. getAvailableMemory{MEMORY_TYPE_TR 

ANSIENT_RESET) 

2- If length < 32767, {test case could be 
performed) 

2.1- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_RESET) 

2.2- Applet calls method 
getTheAdminFileView{) with AID = ADFl 

with event 
JCSystem. CLEAR ON RESET 


1 - No Exception shall be thrown 

2.1- No Exception shall be thrown 

2.2- 

SystemException.NO_TRANSIENT 
_SPACE is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


NO TRANSIENT SPACE SystemExceptlon 
with CLEAR_ON_DESELECT FlleVlew object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method length = 

JCSystem.getAvailableMemory{MEMORY_TYPE_TR 
ANSIENT_DESELECT) 

3- If length < 32767, {test case could be 
performed) 

3.1- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem.CLEAR ON DESELECT) 

} 

3.2- Applet calls method 
getTheAdminFileViewO with AID = ADFl 

with event : 
JCSystem . CLEAR_ON_DESELECT 

4- Reset 


1- Appletl is triggered 

2- No Exception shall be thrown 

3.1- No Exception shall be thrown 

3.2- SystemExceptlon. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemExceptlon 

1- Invoke the method getTheAdminFileViewO 
with every event codes except: 0, 1, 2 


1- 

System Exception . 1 LLEGAL_VALU 

E is thrown 




8 


NullPolnterExceptlon 

Invoke the method getTheAdminFileViewO 
with AID = NULL 

with event : 
1 - JCSystem. CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPolnterExceptlon 





5.3.2.3 Method getTheAdminFileView(byte[] buffer, short bOffset, short bLength, 

byte event) 

Test Area Reference: Api_4_Afb_Gtaf_Bsbb. 

5.3.2.3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static AdminFileView getTheAdminFileView {byte [] buffer, short bOffset, short bLength, byte 
event) 

throws NullPointerException, 

j avacard . framework . SystemExceptlon, 

ArraylndexOutOfBoundException 



5.3.2.3.1.1 



Normal execution 



CRRNl: returns a reference to class which implements the AdminFileView interface on an ADF file system 
defined by its AID. 

CRRN2: returns null if the ADF with the full AID given in the buffer does not exist. 

CRRN3: returns null if one of the javacard.framework.Applet.register(..) method has not previously invoked 
by the applet invoking this method or the filesystem server does not exist or the filesystem server returns null. 

CRRN4; After a successful invocation of the method the ADF is the currently selected file. 
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• CRRN5: A separate and independent file context shall be associated with each and every AdminFileView 
object: the operation performed on files in a given File View object shall not affect the file context associated 
with any other AdminFileView object. This context can be transient or persistent depending on what was 
required by the Applet during the creation of the AdminFileView object. 

• CRRN6: It is not possible to access files which are not located under the ADF. 

5.3.2.3.1.2 Parameters error 

• CRRPl : If event is not one of the following values JCSystem.NOT_A_TRANSIENT_OBJECT, 
JCSystem.CLEAR_ON_DESELECT, or JCSystem.CLEAR_ON_RESET a SystemException is thrown. The 
value of the SystemException shall be SystemException.ILLEGAL_V ALUE. 

• CRRP2: If the buffer is null a NullPointerException shall be thrown. 

• CRRP3: if bLength is less then 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: if bOffset plus bLength is greater than the length of the array buffer. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5; if bLength is not in the range of 5 - 16 bytes a SystemException.ILLEGAL_VALUE shall be thrown. 

5.3.2.3.1.3 Context errors 

• CRRCl : If event is JCSystem.CLEAR_ON_RESET or JCSystem.CLEAR_ON_DESELECT and not enough 
transient memory space is available a SystemException shall be thrown with reason code 
SystemException.NO_TRANSIENT_SPACE. 

• CRRC2: If event is JCSystem.CLEAR_ON_DESELECT and the applet is not a currently selected applet a 
SystemException with reason code SystemException.ILLEGAL_TRANSIENT shall be thrown. 

5.3.2.3.2 Test area files 

Test Source: Test_ Api_4_Afb_Gtaf_Bsbb.java. 
Test Applet: Api_4_Afb_Gtaf_Bsbb.java. 

Cap File: Api_4_Afb_Gtaf_Bsbb.cap. 

5.3.2.3.3 Test coverage 



CRR number 


Test case number 


N1 


2 


N2 


3 


N3 


1 


N4 


2 


N5 


11, 12 


N6 


5 


P1 


2 


P2 


5 


P3 


7 


P4 


8 


P5 


9 


C1 


11, 12 
Testable only if available transient space is lower than 32767 


C2 


6 
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5.3.2.3.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


IVIethod returns null 

1- Install Appletl with full access rights 
on the UICC file system 








2- Invoke the method getTheFileView 
before the 


2- returns null 






javacard. framework. Applet . register { . . ) 








method invocation 








Invoke the method getTheAdminFileView { ) 








with buffer[20] = {ADFl,...} 








bOffset= 








bLength= 16 








3- Envelope menu selection is sent to the 


3- Applet is triggered 






UICC 








4- Invoke the method getTheAdminFileView 


4- returns null 






before the 








javacard. framework. Applet . register { . . ) 








method invocation 








Invoke the method getTheAdminFileView { ) 








with buffer [] = unknown aid 






2 


Normal execution 








1- Envelope menu selection is sent to the 
UICC 


1- Appletl is triggered 






Invoke the method getTheAdminFileView { ) 
with buffer[20] = {ADFl,...} 


No Exception shall be thrown 






bOffset= 








bLength= 16 








JCSystem . NOT_A_TRANSIENT_OBJECT 








and stores the result in a class variable 








FVl 








Appletl calls FVl. status {) command 


Current selected DF is ADF1 






Select DFTest using FVl 








Select EFTARU using FVl 








Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








2 - Envelope menu selection is sent to the 


2- Appletl is triggered 






UICC 








Appletl calls FVl. status {) command 


Current selected DF is DFTest 






Read first 3 bytes using FVl 


Expected value is {FF FF FF} 






Appletl calls FVl . select (EFRFUl) 


UlCCExceptionUICCException.FIL 
E_NOT_FOUND is thrown 






Invoke the method getTheAdminFileView { ) 








with the event JCSystem. CLEAR_ON_RESET and 
stores the result in a class variable FV2 


No exception shall be thrown 






Appletl calls FV2. status {) command 


Current selected DF is ADF1 






Select DFTest using FV2 








Select EFTARU using FV2 








Read first 3 bytes using FV2 


Expected value is {FF FF FF} 






Reset 








Terminal profile 








4 - Envelope menu selection is sent to the 


4- Appletl is triggered 






UICC 








Appletl calls FV2. status {) command 


Current selected DF is ADF1 
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Id 



Description 



API Expectation 



APDU Expectation 



Read first 3 bytes using FV2 



Appletl calls FV2 . select (EFRFUl) 



5- Select the Applet by AID 

Invoke the method getTheAdminFileView { ) 

with AID = ADFl with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

the event :JCSystem.CLEAR_ON_DESELECT and 

stores the result in a class variable FV3 

Appletl calls FV3. status {) command 
Select DFTest using FV3 
Select EFTARU using FV3 
Read first 3 bytes using FV3 

S- Select the Applet by AID 

Appletl calls FV3. status {) command 

Read first 3 bytes using FV3 



Appletl calls FV3 . select (EFRFUl) 



UICCException.NO_EF_SELECTE 
D. 

UICCException.FILE_NOT_FOUN 
D is thrown 



5- Appletl is selected 

No Exception shall be thrown 



Current selected DF is ADF1 

Expected value is {FF FF FF} 

6- Appletl is selected 

Current selected DF is ADF1 

UICCException.NO_EF_SELECTE 
D. 



UICCException.FILE_NOT_FOUN 
D is thrown 



FileView context independency 

1- Envelope menu selection is sent to the 
UICC 

2- Check that previous fileviews are 
different {FVl != FV2 != FV3 ) 

3- Select DFTest/EFLARU using FVl 

4- Select DFTest/EFCARU using FV2 

5- Select DFTest/EFCARU using FV3 

6- Read record number 1 using FVl {in 
absolute mode) 

7- Read record number 2 using FV2 {in 
absolute mode) 



1- Appletl is triggered 

3- No exception shall be thrown 

4- No exception shall be thrown 

5- An exception shall be thrown 

6- Expected value is "55 55 55 55" 

7- Expected value is "AA AA AA" 



ILLEGAL_TRANSIENTSystemException 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl calls getTheAdminFileView { ) 
method with 

buffer[20] = {ADFl,...} 

bOffset= 

bLength= 16 

with 

the event JCSystem. CLEAR_ON_DESELECT 



1- Appletl is triggered 



2- SystemException. 

ILLEGAL TRANSIENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


NO TRANSIENT SPACE System Exception 
with CLEAR_ON_RESET FileView object 

1- Get the available transient memory 
space using method length = 

JCSystem.getAvailableMemory{MEMORY_TYP_TRA 
NSIENT_RESET) 

2- If length < 32767, {test case could be 
performed) 

2.1- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR_ON_RESET) 

2.2- Applet calls method 
getTheAdminFileViewO with buffer[20] = 
{ADFl,...} 

bOffset= 
bLength= 16 
with the event 
JCSystem. CLEAR_ON_RESET 


1- No Exception shall be thrown 

2.1- No Exception shall be thrown 

2.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




6 


NO TRANSIENT SPACE SystemException 
with CLEAR_ON_DESELECT FileView object 

1 - Select the Applet by AID 

2- Get the available transient memory 
space using method length = 

JCSystem. getAvailableMemory{MEMORY_TYPE_TR 
ANSIENT_DESELECT) 

3- If length < 32767, {test case could be 
performed) 

3.1- Fill the available transient memory 
space by creating array, using method 
JCSystem . makeTransientByteArray { length , 
JCSystem. CLEAR ON DESELECT) 

} 

3.2- Applet calls method 
getTheAdminFileView{) with buffer [20] = 
{ADFl,...} 

bOffset= 

bLength= 16 

with event : 

JCSystem . CLEAR_ON_DESELECT 

4- Reset 


1- Appletl is triggered 

2- No Exception shall be thrown 

3.1- No Exception shall be thrown 

3.2- SystemException. 
NO_TRANSIENT_SPACE is 
thrown 




7 


ILLEGAL_VALUE SystemException 

1- Invoke the method getTheAdminFileView { ) 
with every event codes except: 0, 1, 2 


1- 

SystemException.lLLEGAL_VALU 
E is thrown 




8 


NullPointerException 

Invoke the method getTheAdminFileView { ) 
with buffer [20] = null 
bOffset= 
bLength= 16 
with event : 
1 - JCSystem. CLEAR_ON_RESET 


1- Shall be thrown 

java.lang. NullPointerException 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


ArraylndexOutOfBoundsException 

l-Envelope menu selection is sent to the 
UICC 

Invoke the method getTheAdminFileView { ) 

with buffer [20] = {adfI,...} 

bOffset= 5 

bLength= 16 

event =JCSystem. CLEAR_ON_RESET 

Invoke the method getTheAdminFileView { ) 

with buffer [20] = {adfI,...} 

bOffset= -1 

bLength= 16 

event =JCSystem. CLEAR_ON_RESET 


1- Appletl is triggered 

Shall be thrown 
ArraylndexOutOfBoundsException 

Shall be thrown 
ArraylndexOutOfBoundsException 




10 


SystemException.lLLEGAL_VALUE 

l-Envelope menu selection is sent to the 
UICC 

Invoke the method getTheAdminFileView { ) 

with buffer[20] = {ADFI,...} 

bOffset= 

bLength= 4 

event =JCSystem. CLEAR_ON_RESET 

Invoke the method getTheAdminFileView { ) 

with buffer[20] = {ADFI,...} 

bOffset= 

bLength= 17 

event =JCSystem. CLEAR_ON_RESET 


1- Appletl is triggered 

SystemException.lLLEGAL_VALU 
E shall be thrown 

System Exception. ILLEGAL_VALU 
E shall be thrown 





5.3.3 Class AdminException 
5.3.3.1 Constructor 

Test Area Reference: Api_4_Aex_Coor. 

5.3.3.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public AdminException {short reason) 

5.3.3.1 .1 .1 Normal execution 

• CRRNl: Constructs an AdminException with the specified reason. 

5.3.3.1.1.2 Parameter errors 
No requirements. 

5.3.3.1.1.3 Context errors 
No requirements. 



5.3.3.1.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Api_4_Aex_Coor.j ava. 
Api_4_Aex_Coor_ 1 .j ava. 
Api_4_Aex_Coor.cap. 
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5.3.3.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1 



5.3.3.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


AdminException with the specified reason 

{The reason shall set with setReason 
and compare the Exception with 
getReason) 


Reason (specified) 





5.3.3.2 Method throwit 

Test Area Reference: Api_4_Aex_Thit. 

5.3.3.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static void throwit {short reason) 
throws AdminException 

5.3.3.2.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of AdminException with the specified reason. 

• CRRN2: Etends javacard.framework.CardRuntimeException. 



5.3.3.2.1.2 

No requirements. 

5.3.3.2.1.3 

No requirements. 

5.3.3.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.3.3.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Api_4_Aex_Thit.j ava. 
Api_4_Aex_Thit_ 1 .j ava. 
Api_4_Aex_Thit.cap. 

Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 
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5.3.3.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of AdminException with 
the specified reason 


Reason = 




2 


Throws the JCRE instance of AdminException with 
the specified reason 


Reason = 1 




3 


Throws the JCRE instance of AdminException with 
the specified reason 


Reason = 0xA55A 




4 


AdminException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


AdminException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


AdminException extends 
javacard.framework.CardRuntimeException 


Reason = 0xA55A 





5.3.3.3 Reason Codes 

Test Area Reference: Api_4_Aex_Cons. 

5.3.3.3.1 Conformance Requirement: 

There is no API, only constants. These constants shall compliant to its definition in the API. 

5.3.3.3.1.1 Normal execution 

• CRRNl: The Constants of the class AdminException shall all have the same name and value defined in the 
TS 102 241 [9]. 

• CRRN2: Constructs AdminException an Exception with the specified reason. 



5.3.3.3.1.2 


Parameter errc 


No requirements. 




5.3.3.3.1.3 


Context errors 


No requirements. 




5.3.3.3.2 


Test area files 


None. 




5.3.3.3.3 


Test Coverage 



CRR number 


Test case number 


Nl & N2 


The constants in Java are resolved at compilation time, therefore a runtime test is not 
useful. No test of constants will be performed 



5.3.3.3.4 
None. 



Test Procedure 
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5.4 Package uicc.system 

5.4.1 Class HandlerBuilder 

5.4.1 .1 Method buildTLVHandler(byte type, short capacity) 

Test Area Reference: Api_3_Hdb_Bthdbs. 

5.4.1 .1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ViewHandler buildTLVHandler {byte type, 

short capacity) 
throws Java . lang. ArraylndexOutOfBoundsException, 
j avacard . framework . SystemException 

5.4.1.1.1.1 Normal execution 

• CRRNl: Allocates a TLVHandler with an internal buffer of length capacity. 

5.4.1.1.1.2 Parameter errors 

• CRRPl : If the type parameter does not match with the predefined values, a 
javacard.framework.SystemException is thrown with ILLEGAL_VALUE reason code. 

• CRRP2: If capacity is negative, a j avacard. framework. SystemException is thrown with ILLEGAL_VALUE 
reason code. 



5.4.1.1.1.3 



Context errors 



CRRCl: If there are not enough resources in the card to allocate the handler, a 
javacard.framework.SystemException is thrown with NO_RESOURCE reason code. 



5.4.1.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.4.1.1.3 



Test area files 

Test_Api_3_Hdb_Bthdbs.java. 
Api_3_Hdb_Bthdbs_l .Java. 
Api_3_hdb_bthdbs . cap . 

Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


4,5 


P2 


3 


C1 


Not testable 
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5.4.1.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call buildTLVHandlerO method with 
EDIT_HANDLER type 

Type = EDIT_HANDLER 

Capacity = (short) 10 

Check the created object is not null 


No exception shall be thrown 




2 


Call buildTLVHandlerO method with 
BER_EDIT_HANDLER type 

Type = BER_EDIT_HANDLER 

Capacity = (short) 10 

Check the created object is not null 


No exception shall be thrown 




3 


Negative capacity 

Type = EDIT_HANDLER 
Capacity = (short) -10 


A 

javacard.framework.SystemE 
xception is thrown with 
ILLEGAL_VALUE reason 
code.. 




4 


Type does not match with predefined 
values 

Type = (byte) 3 
Capacity = (short) 10 


javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 




5 


Type does not match with predefined 
values 

Type = (byte) 
Capacity = (short) 10 


javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 





5.4.1 .2 Method buildTLVHandler(byte type, short capacity, byte[] buffer , short 

bOffset, short bLength) 

Test Area Reference: Api_3_Hdb_Bthdbs_Bss. 

5.4.1.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ViewHandler buildTLVHandler (byte type, 

short capacity, 
byte [] buffer, 
short bOffset, 
short bLength) 
throws j ava . lang . ArraylndexOutOf BoundsException, 
j avacard . framework . SystemException, 
Java . lang.NullPointerException 

5.4.1.2.1.1 Normal execution 

• CRRN 1 : Allocates a TLVHandler with an internal buffer of length capacity. 

• CRRN2: Copies the buffer content to an internal buffer of the TLVHandler starting at bOffset. 

• CRRN3: The internal buffer shall be at least bLength long. 



5.4.1.2.1.2 



Parameter errors 



CRRPl: If the type does not match with the predefined values, a javacard.framework.SystemException is 
thrown with ILLEGAL_VALUE reason code. 

CRRP2: If buffer is null, a Java. lang.NullPointerException is thrown. 



ETSI 



Release 6 



519 



ETSI TS 102 268 V6.1.0 (2013-06) 



CRRP3: If bOffset would cause access outside array bounds, anjava.lang.ArraylndexOutOfBoundsException 
is thrown. 

CRRP4: if bLength is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

CRRP5: If capacity is negative, a javacard. framework. SystemException is thrown with ILLEGAL_VALUE 
reason code. 

CRRP6: If bOffset+b Length is greater than the length of the buffer, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



5.4.1.2.1.3 



Context errors 



• CRRCl: If there are not enough resources in the card to allocate the handler, a 

javacard. framework.SystemException is thrown with NO_RESOURCE reason code. 

5.4.1.2.2 Test area files 

Test Source: Test_Api_3_Hdb_Bthdbs_Bss.java. 
Test Applet: Api_3_Hdb_Bthdbs_Bss_l.java. 

Cap File: Api_3_hdb_bthdbs_bss.cap. 



5.4.1.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


6 


N3 


1,2,6 


PI 


4,5 


P2 


7 


P3 


8,9 


P4 


10 


P5 


3 


P6 


11 


CI 


Not testable 



5.4.1.2.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call buildTLVHandlerO method with 
EDIT_HANDLER type 

Type = EDIT_HANDLER 

Capacity = (short) 10 

Buffer [10] 

Offset = (short) 

Length = (short) 

ChecJc the created object is not null 


No exception shall be thrown 




2 


Call buildTLVHandlerO method with 
BER_EDIT_HANDLER type 

Type = BER_EDIT_HANDLER 

Capacity = (short) 10 

Buffer [10] 

Offset = (short) 

Length = (short) 

ChecJ: the created object is not null 


No exception shall be thrown 




3 


Negative capacity 

Type = EDIT_HANDLER 
Capacity = (short) -10 
Buffer [10] 
Offset = (short) 
Length = (short) 5 


A 

javacard.framework.SystemE 
xception is thrown with 
ILLEGAL_VALUE reason 
code.. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Type does not match with predefined 
values 

Type = (byte) 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 
Length = (short) 5 


A 

javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 




5 


Type does not match with predefined 
values 

Type = (byte) 3 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 
Length = (short) 5 


A 

javacard.framework.SystemE 
xception shall be thrown with 
ILLEGAL_VALUE reason 
code. 




6 


Internal Buffer starts at bOffset 

Type = EDIT_HANDLER 

Capacity = (short) 10 

Buffer [10] 

Offset = (short) 4 

Length = (short) 5 

ChecJ: the internal buffer of the 

TLVHandler starts with bOffset data. 


No exception shall be thrown 




7 


Buffer is null 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [] = null 
Offset = (short) 
Length = (short) 5 


A 

java.lang.NullPointerExceptio 
n shall be thrown. 




8 


bOffset > Buffer Length 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 11 
Length = (short) 


A 

java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 




9 


bOffset < 

Type = EDIT_HANDLER 
Capacity: (short) 10 
Buffer [10] 
Offset = (short) -1 
Length = (short) 


A 

Java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 




10 


bLength < 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [10] 
Offset = (short) 
Length = (short) -1 


A 

Java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 




11 


bOffset+bLength > buffer length 

Type = EDIT_HANDLER 
Capacity = (short) 10 
Buffer [10] 
Offset = (short)? 
Length = (short) 8 


A 

Java.lang.ArraylndexOutOfBo 
undsException shall be 
thrown. 
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5.4.2 Interface UlCCPIatform 
5.4.2.1 Method getTheVolatileByteArray 

Test Area Reference: Api_3_Upf_Gvba. 

5.4.2.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static byte [] getTheVolatileByteArray { ) 

5.4.2.1.1.1 Normal execution 

• CRRNl: Returns the instance of the volatile byte array designated by the JCRE as global array. The byte array 
length shall be at least equal to 256 bytes. 



5.4.2.1.1.2 
No requirement. 

5.4.2.1.1.3 



Parameter errors 



Context errors 



• CRRCl : If the method is invoked from a context which is not the currently selected applet or the currently 
triggered applet i.e. the context of the applet that treats the current APDU or the context of the applet that has 
been triggered by the current APDU, a java.lang.SecurityException is thrown. 

• CRRC2: A reference to this byte array cannot be stored in class variables or instance variables or array 
components. 

5.4.2.1.2 Test area files 

Test Source: Test_Api_3_Upf_Gvba.java. 
Test Applet: Api_3_Upf_Gvba_l.java. 

Api_ShareableInterface.java. 

Api_GetShareableClientApplet.java. 
Cap File: Api_3_upf_gvba.cap. 

Api_3_upf_gvba2.cap. 

5.4.2.1.3 Test coverage 



CRR number 


Test case number 


N1 


1 


01 


2 


C2 


3,4,5 



ETSI 



Release 6 



522 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.4.2.1.4 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call getTheVolatileByteArrayO method and 
store it in a local variable 

1- Trigger the applet and check the 
returned byte array length is at least 
equal to 256 bytes. 

2- Select the applet and check the 
returned byte array length is at least 
equal to 256 bytes. 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 




2 


Method invoked from a different context 

By the way of the Shareable Interface, 
call the getTheVolatileByteArrayO method 
through another applet . 


A java.lang.SecurityException 
shall be thrown. 




3 


Store the instance in a class variable 


A java.lang.SecurityException 
shall be thrown. 




4 


Store the instance in an instance variable 


A java.lang.SecurityException 
shall be thrown. 




5 


Store the instance in an array component 


A java.lang.SecurityException 
shall be thrown. 
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5.5 CAT Runtime Environment 
5.5.1 IVlin I mum Handler Availability 

This test area tests the rules that define the minimum requirements for the availability of the system handlers. 

5.5.1.1 ProactiveHandler 

Test Area Reference: Cre_Mha_Pahd. 

5.5.1 .1 .1 Conformance requirement 

5.5.1.1.1.1 Normal execution 

• CRRNl: If a proactive session is not ongoing the ProactiveHandler is available from the invocation to the 
termination of the processToolkit method for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_PROFILE_DOWNLOAD 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_PROACTIVE_HANDLER_AV AIL ABLE 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT EVENT BROWSING STATUS 
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EVENT_EXTERNAL_FILE_UPDATE 

• CRRN2: A ProactiveHandler is considered available when no HANDLER_NOT_AVAILABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

• CRRN3: When available the ProactiveHandler shall remain available until the termination of the 
processToolkitO method. 

• CRRN4: If a proactive command is pending the ProactiveHandler may not be available. 

5.5.1.1.1.2 Parameter errors 
No requirements. 

5.5.1.1.1.3 Context errors 

• CRRCl: The ProactiveHandler and its content are not available for any toolkit applet triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_APPLICATION_DESELECT 

• CRRC2: The ProactiveHandler shall not be available if the Terminal Profile command has not yet been 
processed by the CAT Runtime Environment 

• CRRC3: The ProactiveHandler shall not be available if the getTheHandler() method is not called, directly or 
indirectly, from the applet's processToolkitQ method. 



5.5.1.1.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.1.3 



Test area files 

Test_Cre_Mha_Pahd.j ava. 
Cre_Mha_Pahd_l .Java. 
Cre_Mha_Pahd_2.j ava. 
Cre_Mha_Pahd_3 .j ava. 
Cre_Mha_Pahd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


2 to 23, 45, 46 


CRRN2 


1 to 22,45,46 


CRRN3 


2 to 22, 45, 46 


CRRN4 


Not testable 


CRRCl 


1,24 


CRRC2 


25 to 44 or also tested in TestCases 25 to 44 in Cre Mha Prhd 


CRRC3 


47 
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5.5.1.1.4 



Test procedure 



Id 



Description 



API /Framework Expectation 



APDU Expectation 



Applets registration to all events and Proactive 

Handler availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

Appletl is registered to all events 
defined in TS 102 241 [9] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 
Using the methods initMenuEntry { ) for 
EVENT_MENU_SELECTION, 
requestPollInterval { ) for 

EVENT_STATUS_COMMAND , allocateTimer { ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier { ) for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList { ) for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaeu of the UICC file system 

Applet2 is registered to all events 
defined in TS 102 241 [9] , except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_CALL_CONTROL_BY_NAA . 
Using the methods initMenuEntry { ) for 
EVENT_MENU_SELECTION, 
requestPollInterval { ) for 

EVENT_STATUS_COMMAND , allocateTimer { ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 
Applet2 is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaru of the UICC file system 

The priority of Appletl is higher than 
priority of Applet2 

1- Select MF 



2- Appletl gets the Proactive Handler. 
Appletl is deregistered from 
EVENT FIRST COMMAND AFTER ATR . 



3- Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT FIRST COMMAND AFTER ATR. 



1- Appletl is triggered by 
EVENT_FIRST_COI\/ll\/IAND_AFTE 
R_ATR 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 

Applet2 is triggered by 

EVENT_FIRST_COMMAND_AFTE 

R_ATR 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 



Proactive Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of SET UP EVENT 
LIST, POLL INTERVAL, SET UP IDLE MODE TEXT 
and SET UP MENU. 

2- Appletl gets the Proactive Handler 
Appletl is deregistered to 

EVENT PROFILE DOWNLOAD 



3- Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT PROFILE DOWNLOAD 



1- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



2- No exception is thrown 
Appletl finalizes. 

Applet2 is triggered by 
EVENT_PROFILE_DOWNLOAD 

3- No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 






Applet2 finalizes 




3 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported, without facility 
S ET_UP_E VENT_L 1ST 

1- Envelope menu selection with help 
request is sent to the UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




4 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




5 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




6 


Proactive Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




7 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3-No exception is thrown 

Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


8 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




9 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




10 


Applets triggering with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




11 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


12 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




13 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




14 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE SE 

LECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




15 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


16 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




17 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 

1- Appletl builds a proactive command OPEN 
CHANNEL proactiveHandler . send { ) method is 
called. 

2- An Envelope Event Download Data 
Available is sent to the UICC, with 
channelld=01 . 

3- Appletl gets the Proactive Handler 


2- Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


1- OPEN CHANNEL 
proactive Command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 


18 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- An Envelope Event Download Channel 
Status is sent to the UICC, with 
Channelld=01 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


19 


Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope {BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




20 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




21 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 
4-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 
Applet2 finalizes 


3- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful 
TERMINAL RESPONSE is 
issued 


22 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNE 

CTION 

1- An envelope event download local 
connection is sent to the UICC, with the 
allocated service identifier 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


23 


Proactive Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 








1- Envelope event download call connected 
is sent to the UICC 


1 - Appletl is triggered and registers 

to 

EVENT PROACTIVE HANDLER 

AVAILABLE 

Appletl finalizes 

Applet2 is triggered, registers to 

EVENT_PR0ACT1VE_HANDLER_ 

AVAILABLE and sends a Display 

Test proactive command 






2 -The display Text proactive command is 
fetch and the terminal response is sent 


2- Appletl is triggered by 
EVENT PROACTIVE HANDLER 
AVAILABLE 






3-Appletl gets the Proactive Handler 


3- No exception is thrown 






4-Applet2 gets the Proactive Handler 


Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 

4- No exception is thrown 

Applet2 finalizes 




24 


Proactive Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 








2- Select for termination ADFl 


2- Appletl is triggered 






3- Appletl gets the Proactive Handler 
Appletl deregisters to 
EVENT_APPLICATION_DESELECT . 


3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 






4-Applet2 gets the Proactive Handler 
Applet2 deregisters to 
EVENT_APPLICATION_DESELECT 


4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




25 


The ProactiveHandler is not available before 

the Terminal Profile with EVENT MENU 

SELECTION_HELP_REQUEST 

1- Reset the card without sending the 
Terminal Profile 








2- Envelope menu selection with help 
request is sent to the UICC 


2- Appletl is triggered 






3- Appletl gets the Proactive Handler 


3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


26 


The ProactiveHandler is not available before 

the Terminal Profile with EVENT MENU 

SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




27 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




28 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 




29 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


30 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




31 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




32 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


33 


The ProactiveHandler is not available before 

the Terminal Profile with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




34 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




35 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


36 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD LANGUAGE SE 

LECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




37 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




38 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


39 


The ProactiveHandler is not available before 

the Terminal Profile with 

UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope {BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




40 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




41 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 

Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


42 


The ProactiveHandler is not available before 

the Terminal Profile with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 


Appletl and Applet2 are not 

triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 




43 


The ProactiveHandler is not available before 
the Terminal Profile with 

EVENT EVENT DOWNLOAD NETWORK SE 
ARCH_MODE_CHANGE 








1- Envelope event download network search 
mode change is sent to the UICC 


1- Appletl is triggered 






2- Appletl gets the Proactive Handler 


2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl deregisters from 
EVENT PROACTIVE HANDLER 
AVAILABLE 

Appletl finalizes 

Applet2 is triggered 






3- Applet2 gets the Proactive Handler 


3- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Applet2 deregisters from 

EVENT PROACTIVE HANDLER 

AVAILABLE 

Applet2 finalizes 




44 


The ProactiveHandler is not available before 

the Terminal Profile with 

EVENT EVENT DOWNLOAD BROWSING 

STATUS 








1- Envelope event download browsing status 
is sent to the UICC 


1- Appletl is triggered 






2- Appletl gets the Proactive Handler 


2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 






3- Applet2 gets the Proactive Handler 


Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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45 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SE 

ARCH_MODE_CHANGE 

0- Reset card and sendTerminal Profile 
without facility SETUP_EVENT_LIST 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




46 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




47 


The ProactiveHandler is not available outside 
the processToolkitO method 

1- Install Applet3 . In its install method, 
Applet3 gets the ProactiveHandler in a 
Try/Catch session 

2- Select Applet3 

3- Applet3 gets the ProactiveHandler 


1 - A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





5.5.1.2 



ProactiveResponseHandler 



Test Area Reference: Cre Mha Prhd. 



5.5.1.2.1 



5.5.1.2.1.1 



Conformance requirement 
Normal execution 



CRRNl: The ProactiveResponseHandler is available as soon as the ProactiveHandler is available and remains 
available untill the termination of the processToolkit method for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT TIMER EXPIRATION 
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EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_PROFILE_DOWNLOAD 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_PROACTIVE_HANDLER_AV AIL ABLE 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_BROWSING_STATUS 

EVENT_EXTERNAL_FILE_UPDATE 

• CRRN2: A ProactiveResponseHandler is considered available when no HANDLER_NOT_AVAILABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

5.5.1.2.1.2 Parameter errors 
No requirements. 

5.5.1 .2.1 .3 Context errors 

• CRRCl: The ProactiveResponseHandler and its content are not available for any toolkit applet triggered from 
the invocation to the termination of their processToolkit method for the following events: 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_APPLICATION_DESELECT 

• CRRC2: The ProactiveResponseHandler shall not be available if the ProactiveHandler is not available. 

• CRRC3: The ProactiveResponseHandler shall not be available if the getTheHandler() method is not called, 
directly or indirectly, from the applet's process TbottifO method. 
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5.5.1.2.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.2.3 



Test area files 

Test_Cre_Mha_Prhd.j ava. 
Cre_Mha_Prhd_ 1 .j ava. 
Cre_Mha_Prhd_2.j ava. 
Cre_Mha_Prhd_3 .j ava. 
Cre_Mha_Prhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


2 to 23, 45, 46 


CRRN2 


1 to 22,45,46 


CRRC1 


1,24 


CRRC2 


25 to 44 


CRRC3 


47 



5.5.1.2.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applets registration to all events and Proactive 

Handler availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

Appletl is registered to all events 
defined in TS 102 241 [9] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND , allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier ( ) for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList ( ) for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFTARU of the UICC file system 

Applet2 is registered to all events 
defined in TS 102 241 [9] , except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_CALL_CONTROL_BY_NAA . 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND , allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 
Applet2 is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFTARU of the UICC file system 

The priority of Appletl is higher than 
priority of Applet2 

1- Select MF 



2- Appletl gets the Proactive Handler. 



3- Applet2 gets the Proactive Response 
Handler 



1- Appletl is triggered by 
EVENT_FIRST_COI\/ll\/IAND_AFTE 
R_ATR 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A Tooll<itException 
HANDLER NOT AVAILABLE is 



ETSI 



Release 6 



541 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




Appletl is (Reregistered from 
EVENT_FIRST_COMMAND_AFTER_ATR . 

4- Applet2 get the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 

Applet2 is deregistered to 
EVENT_FIRST_COMMAND_AFTER_ATR . 


thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT FIRST COMMAND Ah 1 b 

R_ATR 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 




2 


Proactive Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of SET UP EVENT 
LIST, POLL INTERVAL, SET UP IDLE MODE TEXT 
and SET UP MENU. 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

Appletl is deregistered to 
E VENT_PROF I LE_DOWNLOAD 

4- Applet2 gets the Proactive Handler 
5-Applet2 gets the Proactive Respones 
Handler 

Applet2 is deregistered to 
E VENT_PROF I LE_DOWNLOAD 


1- Appletl is triggered by 
EVENT_PROFILE_DOWNLOAD 

2- No exception is thrown 

3- No exception is thrown 
Appletl finalizes. 

Applet2 is triggered by 
EVENT_PROFILE_DOWNLOAD 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




3 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported, without facility 
S ET_UP_EVENT_L 1ST 

1- Envelope menu selection with help 
request is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 




4 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 
Appletl finalizes 
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Id 
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API/CAT RE Expectation 


APDU Expectation 


5 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 
Appletl finalizes 




6 


Proactive Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1 - Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 




7 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4-No exception is thrown 
5-No exception is thrown 

Applet2 finalizes 




8 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 
5. No exception is thrown 

Applet2 finalizes 
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API/CAT RE Expectation 


APDU Expectation 


9 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONNE 

CTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




10 


Applets triggering with 

EVENT EVENT DOWNLOAD LOCATION STAT 

US 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




11 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 
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12 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

STATUS 

1 -Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 Is triggered 

4- No exception is thrown 

5- No exception is thrown 
Applet2 finalizes 




13 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




14 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE SEL 

ECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 
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15 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 Is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




16 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




17 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD DATA AVAILABL 

E 

1- Appletl builds a proactive command OPEN 
CHANNEL proactiveHandler . send ( ) method is 
called. 

2- An Envelope Event Download Data 
Available is sent to the UICC, with 
channelld=01 . 

3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 
Handler 


2- Appletl is triggered 

3- No exception is thrown 

4- No exception is thrown 

Appletl finalizes 


1- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 


18 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- An Envelope Event Download Channel 
Status is sent to the UICC, with 
Channelld=01 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
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Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




20 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




21 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARAM 

ETERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

5- Applet2 gets the Proactive Handler 

6- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 
Applet2 is triggered 

5- No exception is thrown 

6- No exception is thrown 

Applet2 finalizes 


4- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 
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Proactive Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNEC 

TION 








1- An envelope event download local 


1- Appletl is triggered 






connection is sent to the UICC, with the 






allocated service identifier 








2- Appletl gets the Proactive Handler 








3- Appletl gets the Proactive Response 


2- No exception is thrown 






Handler 


3- No exception is thrown 
Appletl finalizes 




23 


Proactive Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 








1- Envelope event download call connected 


1 - Appletl is triggered and registers 






is sent to the UICC 


to 

EVENT PROACTIVE HANDLER 

AVAILABLE 

Appletl finalizes 

Applet2 is triggered, registers to 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE and sends a Display 






2- The display Text proactive command is 


Test proactive command 






fetch and the terminal response is sent 


2- Appletl is triggered by 
EVENT PROACTIVE HANDLER 






3- Appletl gets the Proactive Handler 


AVAILABLE 






4- Appletl gets the Proactive Response 








Handler 


3- No exception is thrown 

4- No exception is thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 






5- Applet2 gets the Proactive Handler 


AVAILABLE 






6- Applet2 gets the Proactive Response 








Handler 


4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 
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24 


Proactive Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 

2- Select for termination ADFl 

3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 
Handler 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT . 

5-Applet2 gets the Proactive Handler 

6-Applet2 gets the Proactive Response 
Handler 

Applet2 deregisters to 
EVENT_APPLICATION_DESELECT . 


2- Appletl is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

4- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

6- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




25 


The ProactiveHandler is not available before the 

Terminal Profile with EVENT MENU 

SELECTION_HELP_REQUEST 

1- Reset the card without sending the 
Terminal Profile 

2- Envelope menu selection with help 
request is sent to the UICC 

3- Appletl gets the Proactive Handler 

4- Appletl gets the Proactive Response 
Handler 


2- Appletl is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




26 


The ProactiveHandler is not available before the 

Terminal Profile with EVENT MENU 

SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
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27 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_TIMER_EXPIRATION 

1- Timer Id =1 

Envelope Timer Expiration is sent to the 
UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




28 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




29 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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30 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




31 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD CALL DISCONNE 

CTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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32 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD LOCATION STAT 

US 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




33 


The ProactiveHandler is not available before the 

Terminal Profile with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5-A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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34 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD IDLE SCREEN A 

VAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 




35 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD CARD READER 

STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 
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36 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD LANGUAGE SEL 

ECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

3--A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

5-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Applet2 finalizes 




37 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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38 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

5A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Applet2 finalizes 




39 


The ProactiveHandler is not available before the 

Terminal Profile with 

UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 





ETSI 



Release 6 



555 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


40 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- An envelope event download access 
technology change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

5-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Applet2 finalizes 




41 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT EVENT DOWNLOAD DISPLAY PARAM 

ETERS_CHANGED 

1- An envelope event download display 
parameter changed is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

3-A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown. 

Appletl registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 

Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 registers to 

EVENT PROACTIVE HANDLER 

AVAILABLE then finalizes 




42 


The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_PROACTIVE_HANDLER_AVAILABLE 


Appletl and Applet2 are not 

triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 
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43 



The ProactiveHandler is not available before 
the Terminal Profile with 

EVENT_EVENT_DOWNLOAD_NETWORK_SE 
ARCH_MODE_CHANGE 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 



3- Appletl gets the Proactive Response 
Handler 



4- Applet2 gets the Proactive Handler 



5- Applet2 gets the Proactive Response 
Handler 



1- Appletl is triggered 



2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl (Reregisters from 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 

Appletl finalizes 

Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 deregisters from 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 



Applet2 finalizes 



44 



The ProactiveHandler is not available before the 

Terminal Profile with 

EVENT_EVENT_DOWNLOAD_BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 



3- Appletl gets the Proactive Response 
Handler 



4- Applet2 gets the Proactive Handler 



5- Applet2 gets the Proactive Response 
Handler 



1- Appletl is triggered 



2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 
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45 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SEAR 

CH_MODE_CHANGE 

0- Reset card and sendTerminal Profile 
without facility SETUP_EVENT_LIST 

1- Envelope event download network search 
mode change is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




46 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSING 

STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- Appletl gets the Proactive Handler 

3- Appletl gets the Proactive Response 
Handler 

4- Applet2 gets the Proactive Handler 

5- Applet2 gets the Proactive Response 
Handler 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 

5- No exception is thrown 

Applet2 finalizes 




47 


The ProactiveHandler is not available outside 
the processToolkitQ method 

1- Install Applet3 . In its install method, 
Applet3 gets the Proactive Handler and the 
Proactive Response Handler in a Try/Catch 
session 

2- Select Applet3 

3- Applet3 gets the ProactiveHandler and 
the Proactive Response Handler. 


1 - A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 
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5.5.1.3 EnvelopeHandler 

Test Area Reference: Cre_Mha_Enhd. 

5.5.1.3.1 Conformance requirement 

5.5.1.3.1.1 Normal execution 

• CRRN 1 : The EnvelopeHandler and its content are available for all toolkit applets triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_APPLICATION_DESELECT 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_BROWSING_STATUS 

EVENT_EXTERNAL_FILE_UPDATE 

• CRRN2: An EnvelopeHandler is considered available when no HANDLER_NOT_A VAIL ABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

5.5.1.3.1.2 Parameter errors 
No requirements. 
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5.5.1.3.1.3 



Context errors 



CRRCl: The EnvelopeHandler and its content are not available for any toolkit applet triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_PROACTIVE_HANDLER_AVAILABLE 

CRRC2: The EnvelopeHandler shall not be available if the getTheHandlerQ method is not called, directly or 
indirectly, from the applet's processToolkit{) method. 



5.5.1.3.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.3.3 



Test area files 

Test_Cre_Mha_Enhd.j ava. 
Cre_Mha_Enhd_ 1 .j a va . 
Cre_Mha_Enhd_2 .Java. 
Cre_Mha_Enhd_3 .j ava. 
Cre_Mha_Enhd .cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


3,4,5,6,7,8,9, 10, 11, 12, 13, 14, 15, 17, 18, 19,20,22,24,26,27,28,29 


CRRN2 


1 to 24, 26, 27, 28, 29 


CRRC1 


1,2, 16,23 


CRRC2 


25 
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Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Appletl and Applet2 registration and Envelope 

Handler availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

1- Appletl is registered to all events 
defined TS 102 241 [9] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 

The registration is done using the methods 
initMenuEntryO for EVENT_MENU_SELECTION, 
requestPollInterval { ) for 

EVENT_STATUS_COMMAND , allocateTimer { ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier { ) for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList { ) for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaeu of the UICC file system 

Applet2 is registered to all events 
defined TS 102 241 [9] except to 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_CALL_CONTROL_BY_NAA . 

The registration is done using the methods 
InitMenuEntryO for EVENT_MENU_SELECTION, 
requestPollInterval { ) for 
EVENT_STATUS_COMMAND , allocateTimer for 
EVENT_TIMER_EXPIRATION and setEventList 
for the rest of the events. 
Applet2 is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaru of the UICC file system 

2- Select MF. 



3- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 
Appletl is deregistered from 
EVENT FIRST COMMAND AFTER ATR . 



4- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 
Applet2 is deregistered to 
EVENT FIRST COMMAND AFTER ATR. 



1 - No exception is thrown 



2- Appletl is triggered by 
EVENT_FIRST_COMI\/IAND_AFTE 
R_ATR 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

4- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 



Applet2 finalizes 



Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of 
SET_EVENT_LIST, SETUP_IDLE_MODE_TEXT, 
POLL_INTERVAL and SETUP MENU 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

Appletl is deregistered to 
EVENT PROFILE DOWNLOAD 



3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 
Applet2 is deregistered to 
EVENT PROFILE DOWNLOAD 



1- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT_PROFILE_DOWNLOAD 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 
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3 


Envelope Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1- Appletl is triggered 
2- No exception is thrown 
Appletl finalizes 




4 


Envelope Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1- Appletl is triggered 
2- No exception is thrown 
Appletl finalizes 




5 


Envelope Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 

1- Envelope Timer Expiration is sent to 
the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1- Appletl is triggered 
2- No exception is thrown 

Appletl finalizes 




6 


Envelope Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




7 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




8 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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9 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONE 

CTTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered. 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




10 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




11 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




12 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




13 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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14 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE 

SELECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




15 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD BROWSER 

TERMINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




16 


Envelope Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler {) method 
is called by Applet2 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 
Applet2 is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




17 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 

1- Appletl builds a proactive command OPEN 
CHANNEL . 

proactiveHandler . send { ) method is called 

2- Envelope event download data available 
is sent to the UICC with Channelld=01 . 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1 - Appletl is registered to 

EVENT EVENT DOWNLOAD DA 

TA AVAILABLE and 

EVENT EVENT DOWNLOAD CH 

ANNEL_STATUS 

2- Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


1- OPEN CHANNEL 
proactive command is 
fetched 

TERMINAL RESPONSE is 
issued with Channel Id = 01 
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18 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

1- Envelope event download channel status 
is sent to the UICC with Channelld=01 . 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




19 


Envelope Handler availability with EVENT 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

4- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

3- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 
Applet2 finalizes 


3- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 


20 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNE 

CTION 

1- Envelope event download local 
connection is sent to the UICC with the 
allocated service Id of Appletl 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 




21 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- Envelope event download access 
technology change is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




22 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- Envelope event display parameter 
changed is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1 - Appletl is triggered and registers 

to 

EVENT PROACTIVE HANDLER 

AVAILABLE 

2- No exception is thrown 
Appletl finalizes 

Applet2 is triggered and registers to 
EVENT PROACTIVE HANDLER 
AVAILABLE 

3- No exception is thrown 
Applet2 finalizes 
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API/CAT RE Expectation 


APDU Expectation 


23 


Envelope Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered by 
EVENT PROACTIVE HANDLER 
AVAILABLE 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Applet2 finalizes 




24 


Envelope Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 

2- Select for termination ADFl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl. 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT . 

4- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 . 

Appletl deregisters to 
EVENT APPLICATION DESELECT. 


2- Appletl is triggered 

3- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

4- No exception is thrown 
Applet2 finalizes 




25 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SEA 

RCH_MODE_CHANGE 

1- Envelope event download network search mode 
change is sent to the UICC 

2- EnvelopeHandler.getlheHandlerO method is 
called by Appletl 

3- EnvelopeHandler.getlheHandlerO method is 
called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 




26 


Envelope Handler availability with 
EVENT_EVENT_BROWSING_STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called by Appletl 

3- EnvelopeHandler .getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 
Applet2 finalizes 
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27 


The EnvelopeHandler is not available outside 
the processToolkitO method 

1- Install Applets. In its install method, 
Applets gets the EnvelopeHandler in a 
Try/Catch session 

2- Select Applets 

3- Applets gets the EnvelopeHandler 


1- AToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 





5.5.1.4 EnvelopeResponseHandler 

Test Area Reference: Cre_Mha_Erhd 



5.5.1.4.1 



5.5.1.4.1.1 



Conformance requirement 



Normal execution 



• CRRNl: The handler is available for all triggered toolkit applets from the invocation of the processToolkit 
method of the toolkit applet until a toolkit applet has posted an envelope response or the first invocation of the 
ProactiveHandler.send method for the following events: 

EVENT_CALL_CONTROL_BY_NAA 

EVENT_UNRECOGNIZED_ENVELOPE 

• CRRN2: After a call to the post method the handler is not longer available. 

• CRRN3: After a call to the send method the handler is not longer available. 

• CRRN4: An EnvelopeResponseHandler is considered available when no HANDLER_NOT_AVAILABLE 
ToolkitException is thrown when the corresponding getTheHandler() method is called or a method of the 
handler is called. 

5.5.1.4.1.2 Parameter errors 
No requirements. 

5.5.1 .4.1 .3 Context errors 

• CRRCl: The handler is not available for the following events: 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ ACTIVITY 

EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 
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EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

EVENT_FIRST_COMMAND_AFTER_ATR 

EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

EVENT_APPLICATION_DESELECT 

EVENT_PROACTIVE_HANDLER_AVAILABLE 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

EVENT_EVENT_BROWSING_STATUS 

EVENT_EXTERNAL_FILE_UPDATE 

CRRC2: The EnvelopeResponseHandler shall not be available if the getTheHandler() method is not called, 
directly or indirectly, from the applet's /?race.sirooZA:/f() method. 



5.5.1.4.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.1.4.3 



Test area files 

Test_Cre_Mha_Erhd.j ava. 
Cre_Mha_Erhd_ 1 .j a va . 
Cre_Mha_Erhd_2 .Java. 
Cre_Mha_Erhd_3 .j ava. 
Cre_Mha_Erhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


18, 19,20,21 


CRRN2 


18, 19 


CRRN3 


18, 19 


CRRN4 


1 to 29 


CRRC1 


1 to17and22to25, 26, 27, 28 


CRRC2 


29 
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5.5.1.4.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Toolkit Appletl and Toolkit Applet2 

registration and Envelope Response Handler 

availability with 

EVENT_FIRST_COMMAND_AFTER_ATR 

1- Appletl is registered to all events 
defined in TS 102 241 [9] except 
EVENT_PROACTIVE_HANDLER_AVAILABLE. 
Using the methods initMenuEntry { ) for 
EVENT_MENU_SELECTION, 
requestPollInterval { ) for 

EVENT_STATUS_COMMAND , allocateTimer { ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier { ) for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList { ) for the rest of the events. 
Appletl is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaru of the UICC file system 

Applet2 is registered to 
EVENT_UNRECOGNIZED_ENVELOPE . 

2- Select MF . 

3- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

Appletl is deregistered to 
EVENT FIRST COMMAND AFTER ATR . 


1 - No exception is thrown 

2- Appletl is triggered by 
EVENT FIRST COMMAND ARTE 
R_ATR 

3- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




2 


Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Terminal Profile command is sent to the 
UICC without the facility of 

SET EVENT LIST, SETUP IDLE MODE TEXT, 
SETUP_MENU and POLL_INTERVAL . 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1 - Appletl Is Triggered By 
EVENT_PROFILE_DOWNLOAD 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




3 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform UICC initialization with all the 
facilities supported, except facility SET 
UP EVENT LIST 

1- Envelope menu selection with help 
request is sent to the UICC 

2 - EnvelopeResponseHandler . getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




4 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION 

1- A envelope menu selection is sent to 
the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 
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5 


Envelope Response Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Envelope Timer Expiration is sent to 
the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 




6 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




7 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the UICC 

2 - EnvelopeResponseHandler . getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




8 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

1- Envelope event download call 
disconnected is sent to the UICC 

2 - EnvelopeResponseHandler . getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




9 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

1- Envelope event download location status 
is sent to the UICC 

2- Appletl obtains the Envelope Response 
Handler 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




10 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity 
is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 
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Id 
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API/CAT RE Expectation 


APDU Expectation 


11 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

1- Envelope event download idle screen 
available is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




12 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

1- Envelope event download card reader 
status is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




13 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE 

SELECTION 

1- Envelope event download language 
selection is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




14 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD BROWSER 

TERMINATION 

1- Envelope event download browser 
termination is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




15 


Envelope Response Handler availability with 
EVENT_STATUS_COMMAND 

1- status command is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




16 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 

1- Appletl initializes a proactive command 
OPEN CHANNEL and calls the send { ) method. 

2- Envelope event download data avalaible 
is sent to the UICC with channelld=01 

3- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


2- Appletl is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 


1- The OPEN CHANNEL 
command is fetched 
TERMINAL RESPONSE IS 
SENT TO THE UICC with 
channel ld=01 
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17 



Envelope Response Handler availability with 

EVENT_EVENT_DOWNLOAD_CHANNEL_STAT 

US 

1- Envelope event download channel status 
is sent to the UICC with channelld=01 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 



1- Appletl is triggered 

2- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 



18 



Envelope Response Handler availability with 
EVENT_CALL_CONTROL_BY_NAA 

1- Envelope call control by NAA is sent to 
the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

3- Appletl builds the envelope response 
and it calls the postAsBERTLV{ ) method 

4- Appletl calls all methods of the 
Envelope Response Handler {including the 
inherited method) 



5- Envelope call control by NAA is sent to 
the UICC 

6- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the send{) method 



8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception is thrown 



4- ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown for each method 
Appletl finalizes 

5- Appletl is triggered 



6- No Exception is thrown 



8- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 



3- The envelope response is 
sent 



7- The proactive command 
is fetched and the Terminal 
response is issued 
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19 



Envelope Response Handler availability with 
EVENT_UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

3- Appletl builds the envelope response 
and it calls the postAsBERTLV{ ) or post 
method 

4-Appletl calls all methods of Envelope 
Response Handler {including the inherited 
method) 



5- EnvelopeResponseHandler .getTheHandler { ) 
method is called 



6- An unrecognized Envelope is sent to the 
UICC 

7 - EnvelopeResponseHandler . getTheHandler { ) 
method is called 

8- Appletl builds a proactive command and 
it calls the send{) method 

9- Appletl calls all methods of the 
Envelope Response Handler {including the 
inherited method) 



10- 

EnvelopeResponseHandler . getTheHandler { ) 

method is called by Applet2 



1- Appletl is triggered 

2- No exception is thrown 



4- A Tooll<itException 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 
Applet2 is triggered 

5- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 

Applet2 finalizes 

6- Appletl is triggered 

7- No exception is thrown 



9- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 
Applet2 is triggered 

1 0- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown. 



Applet2 finalizes 



3- The envelope response is 
sent 



9- The proactive command 
is fetched and the Terminal 
response Is issued 



20 



The envelope response is sent when a 
proactive session is ongoing 

1- An unrecognized envelope is sent to the 
UICC. 

2- Proactive command DISPLAY TEXT is built 
and it calls the send{) method. 

3- A call control by NAA envelope is sent 
to the UICC. 

4 - EnvelopeResponseHandler . getTheHandler { ) 
method is called by Appletl 

5- Appletl builds the envelope response 
and it calls the postAsBERTLV{ ) 



1- Appletl is triggered. 

3- Appletl is triggered 

4- No exception is thrown 



2- 91 XX 



5- The envelope response is 

checked 

Expected SW = 91 XX 

Fetch DISPLAY TEXT 

Terminal Response 

DISPLAY TEXT 
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Envelope Response Handler availability with 

EVENT_UNRECOGNIZED_ENVELOPE in case 

of multi-triggering 

1- An unrecognized Envelope is sent to the 
UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

3- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 
Applet2 is triggered 

3- No Exception is thrown 
Applet2 finalizes 




22 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD ACCESS TECHN 

OLOGY_CHANGE 

1- Envelope event download access 
technology change is sent to the UICC 

2 - EnvelopeResponseHandler . getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




23 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD DISPLAY PARA 

METERS_CHANGED 

1- Envelope event download display 
parameter changed is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1 - Appletl is triggered and registers 

to 

EVENT PROACTIVE HANDLER 

AVAILABLE 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




24 


Envelope Response Handler availability with 
EVENT_PROACTIVE_HANDLER_AVAILABLE 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered by 
EVENT PROACTIVE HANDLER 
AVAILABLE 

2- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

3- Appletl sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 

Appletl finalizes 


3- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERMINAL 
RESPONSE is issued 
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Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LOCAL CONNA 

CTION 

1- Envelope event download local 
connection is sent to the UICC with the 
allocated service Id of Appletl 

2 - EnvelopeResponseHandler . getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Tooll<itException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




26 


Envelope Response Handler availability with 
EVENT_APPLICATION_DESELECT 

1- Select for activation ADFl 

2- Select for termination ADFl 

3- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 

Appletl deregisters to 
EVENT_APPLICATION_DESELECT 


2- Appletl is triggered 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 




27 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD NETWORK SEA 

RCH_MODE_CHANGE 

1- Envelope event download network search 
mode change is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




28 


Envelope Response Handler availability with 
EVENT_EVENT_BROWSING_STATUS 

1- Envelope event download browsing status 
is sent to the UICC 

2- EnvelopeResponseHandler .getTheHandler { ) 
method is called by Appletl 


1- Appletl is triggered 

2- A ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown 

Appletl finalizes 




29 


The EnvelopeResponseHandler is not available 
outside the processToolkit() method 

1- Install Applets. In its install method, 
Applets gets the EnvelopeResponseHandler 
in a Try/Catch session 

2- Select Applets 

3- Applets gets the 
EnvelopeResponseHandler 


1 - A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 

2- Applets is triggered by its 
processO method 

3- A ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 
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5.5.2 Handler Integrity 
5.5.2.1 ProactiveHandler 

Test Area Reference: Cre_Hin_Pahd. 

5.5.2.1.1 Conformance requirement 

5.5.2.1 .1 .1 Normal execution 

• CRRNl: At the processToolkit invocation the TLV-List is cleared. 

• CRRN2: After a call to ProactiveHandler. send() method the content of the handler shall not be modified by 
the CAT Runtime Environment. 

• CRRN3: At the call of its init method the content is cleared and then initialized. 



5.5.2.1.1.2 

No requirements. 

5.5.2.1.1.3 

No requirements. 

5.5.2.1.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.2.1.3 



Parameter errors 
Context errors 
Test area files 

Te s t_Cre_Hin_Pahd .Java. 
Cre_Hin_Pahd_ 1 .j ava. 
Cre_Hin_P ahd_2 .Java. 
Cre_Hin_Pahd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRNl 


1,2,3,4 


CRRN2 


3 


CRRN3 


5 
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5.5.2.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


At the processToolkit invocation the TLV-List 
is cleared 

Appletl and Applet2 are registered to 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY. 

1-An envelope containing an event download 
user activity is sent to the UICC 

2-ProactiveHandler .getLength { ) method is 
called by Appletl 


1- Appletl is triggered. 
2- The return value is 




2 


TLV-List change after the init method 
invocation 

ProactiveHandler . init { ) method is called 
by Appletl 

1-ProactiveHandler .getLength { ) method is 
called by Appletl 


1-The return value is 9 




3 


The TLV-List remains unchanged after the 
send() method invocation 

1- ProactiveHandler . send { ) method is 
called by Appletl 

2- ProactiveHandler .getLength { ) method is 
called by Appletl 

It is checked that the content is the same 
than before the calling to send method 
using ProactiveHandler . copy and 
Util . arrayCompare methods 


2- The return value is 9, and its 
contents is the same than before 
the calling to send method 

Appletl finalizes 


1 - The proactive command 
is fetched and the terminal 
response is issued. 


4 


At the processToolkit invocation the TLV-List 
is cleared 

1- ProactiveHandler .getLength { ) method is 
called by Applet2 

2 - ProactiveHandler . getValueLength { ) 
method is called by Applet2 


Applet2 is triggered 

1- The return value is 

2- ToolkitException 
UNAVAILABLE_ELEMENT is 
thrown 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


5 


At tlie call of its init method the content is 
cleared and then initialized 








1- proactiveHandler . init { ) method is 
called by Applet2 


1 - Check that the content of the 
proactive handler corresponds to 
the command defined by the 
parameters of the init() method 






2- proactiveHandler. initCloseChannel { ) 
method is called by Applet2 


2- Checl< that the content of the 
proactive handler corresponds to 
the close channel command 






3- proactiveHandler. initDisplayText { ) 
method is called by Applet2 


3- Check that the content of the 
proactive handler corresponds to 
the display text command 






4- proactiveHandler . initGetInkey{ ) method 


4- Check that the content of the 






is called by Applet2 


proactive handler corresponds to 
the get inkey command 






5- proactiveHandler . initGetlnput { ) method 
is called by Applet2 


5- Check that the content of the 
proactive handler corresponds to 
the get input command 






6- ProactiveHandler . initMoreTime { ) method 
is called by Applet2 


6- Check that the content of the 
proactive handler corresponds to 
the IVIore Time command 






7- proactiveHandler . init { ) method is 


7- Check that the content of the 






called by Applet2 


proactive handler corresponds to 
the command defined by the 
parameters of the init() method 





5.5.2.2 ProactiveResponseHandler 

Test Area Reference: Cre_Hin_Prhd. 



5.5.2.2.1 



5.5.2.2.1.1 



Conformance requirement 
Normal execution 



CRRNl: The ProactiveResponseHandler content shall be updated after each successful call to 
ProactiveHandler. send() method and shall remain unchanged until the next successful call to the 
Proactive Handle r.sendO method. 

CRRN2: The ProactiveResponseHandler TLV list is filled with the comprehension TLV data objects of the 
last TERMINAL RESPONSE APDU command. 

CRRN3: The comprehension TLV data objects shall be provided in the order given in the TERMINAL 
RESPONSE command data. 

CRRN4: The ProactiveResponseHandler TLV list shall be empty before the first call to the 
ProactiveHandler.sendO method. 



5.5.2.2.1.2 

No requirements. 

5.5.2.2.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.2.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.2.2.3 



Test area files 

Test_Cre_Hin_Prhd.j ava. 
Cre_Hin_Prhd_ 1 .j ava. 
Cre_Hin_Prhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 


CRRN3 


2 


CRRN4 


1 



5.5.2.2.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration and 
ProactiveResponseHandler obtaining 

1- Applet is registered to all events 
defined in ETSI TS 102 241 [13] except to 
EVENT_FIRST_COMMAND_AFTER_ATR , 
EVENT_PROACTIVE_HANDLER_AVAILABLE and 
EVENT_APPLICATION_DESELECT . 

Using the methods initMenuEntry for 
EVENT_MENU_SELECTION and 
EVENT_MENU_SELECTION_HELP_REQUEST 
requestPollInterval { ) for 

EVENT_STATUS_COMMAND , allocateTimer { ) for 
EVENT_TIMER_EXPIRATION, 
allocateServiceldentif ier { ) for 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 
setEventList { ) for the rest of the events. 
Applet is registered on 

EVENT_EXTERNAL_FILE_UPDATE on update of 
EFtaru of the UICC file system 

Terminal Profile command is sent to the 
UICC without the facilities of 
SETUP_EVENT_LIST, SETUP_IDLE_MODE_TEXT, 
SETUP_MENU and POLL_INTERVAL . 

2- For each event/triggering: 



1 - No exception is thrown 



ProactiveResponseHandler . getTheHandler { ) 
is called 

4- ProactiveResponseHandler .getLength { ) is 
called 



2- Applet is triggered. 

For the first triggering, the applet 
registers to 

EVENT_PROACTIVE_HANDLER 
AVAILABLE 

3- No exception is thrown 



4- The return value is 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Tlie ProactiveResponseHandler remains 

unchanged after send() method invocation 

until next send() method invocation 








1- Applet builds a proactive command then 




1- A proactive command is 




the ProactiveHandler . send { ) method is 




fetched 




called 




The terminal response is sent 
with length 12 




2- 


2- The ProactiveResponseHandler 






proactiveResponseHandler . getTheHandler { ) 


contains the terminal response. 






method is called 


Comprehension TLV are provided 
in the order of the Terminal 
Response APDU 






3-ProactiveResponseHandler .getLength { ) 


3- The return value is 12 






method is called 








4-ProactiveHandler . init { ) method is called 


4- No exception is thrown and the 
Proactive Response Handler 
remains unchanged 






5-ProactiveHandler . send { ) method is called 




5- A proactive command is 

fetched 

The terminal response is sent 






6- The ProactiveResponseHandler 


with length 15 




6- 


contains the terminal response of 






proactiveResponseHandler . getTheHandler { ) 
method is called 


the second proactive command. 
Comprehension TLV are provided 
in the order of the Terminal 
Response APDU 






7-ProactiveResponseHandler .getLength { ) 


7- The return value is 1 5 






method is called 







5.5.2.3 EnvelopeHandler 

Test Area Reference: Cre_Hin_Enhd. 



5.5.2.3.1 



5.5.2.3.1.1 



Conformance requirement 
Normal execution 



CRRNl: When available, the EnvelopeHandler shall remain available and its content shall remain unchanged 
from the invocation to the termination of the processToolkit() method. 

CRRN2: The EnvelopeHandler TLV list is filled with the Comprehension TLV data objects of the 
ENVELOPE APDU command. The Comprehension TLV data objects shall be provided in the order given in 
the ENVELOPE command data. 

CRRN3: When an applet is triggered by the EVENT _EXTERNAL_FILE_UPDATE event, the system Envelope 
Handler shall be available 

CRRN4: When an applet is triggered by the EVENT _EXTERNAL_FILE_UPDATE event, the Envelope 
Handler shall contains the following COMPREHENSION TLVs (the order of the TLVs given in the system 
EnvelopeHandler is not specified): 

Device Identity with source set to terminal and destination set to UICC, as defined in TS 102 223 [6]; 

File List, as defined in TS 102 223 [6]. The number of files shall be set to one. If a SFI referencing is 
used in the APDU Command, it shall be converted to its File Identifier; 
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AID of the ADF, as defined in TS 102 223 [6], if the updated file belongs to an ADF. In this case, the 
path '3F007FFF' given in the File List indicates the ADF of the UICC application given through the AID. 
If the updated file belongs to the UICC shared file system, the AID TLV object is not present; 

File Update Information object. 



Byte(s) 


Description 


Length 


1 


File Update Information tag 


1 


2 


Length = 4 


1 


3 to 4 


Position 


2 


5 to 6 


Number of bytes updated 


2 



Position depends on the file type: 

In case of transparent file. Position = Offset 

In case of record file. Position = Absolute Record number 

For the INCREASE APDU, the number of bytes updated is the record length. 

CRRN5: The value returned upon a getTagO method invocation is equal to the BER-TLV tag for intra-UICC 
communication, as defined in TS 101 220 [4]. 



5.5.2.3.1.2 

No requirements. 

5.5.2.3.1.3 

No requirements. 

5.5.2.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.2.3.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Hin_Enhd.j ava. 
Cre_Hin_Enhd_ 1 .j a va . 
Cre_Hin_Enhd . cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 to 21 


CRRN2 


1 to 21 


CRRN3 


22,23 


CRRN4 


22,23 


CRRN5 


1 
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5.5.2.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet initialization and Envelope Handler 

integrity checks with 

EVENT_MENU_SELECTION_HELP_REQUEST 








1- Applet is registered to all events 


1-No exception is thrown 






defined in TS 102 241 [9] except 








EVENT_PROFILE_DOWNLOAD , 








EVENT_PROACTIVE_HANDLER_AVAILABLE and 








EVENT_STATUS_COMMAND . 








Using the methods initMenuEntry { ) for 








EVENT_MENU_SELECTION and 








EVENT MENU SELECTION HELP REQUEST, 








allocateTimer {) for EVENT_TIMER_EXPIRATION, 








allocateServiceldentif ier { ) for 








EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION and 








setEventList { ) for the rest of the events. 








Perform UICC initialization with all the 








facilities supported 








Applet is registered on 








EVENT_EXTERNAL_FILE_UPDATE on update of 








EFtaru of the UICC file system and on update 


2- Applet is triggered 






of EFlahu of the ADF file system 








2- Envelope menu selection with help 


3- No exception is thrown. 






request is sent to the UICC 








3- EnvelopeHandler .getTheHandler { ) method 








is called 


4- No exception is thrown 






4- Copy the contents of the envelope 








handler in buffer 1 using 








EnvelopeHandler . copy { ) 








The EnvelopeHandler . findTLVO method is 








called with TAG_HELP_REQUEST 








5- EnvelopeHandler .getTag { ) method is 








called 




6- 91 XX. 




6- A proactive command DISPLAY TEXT is sent 


5- 0xD3 is returned 






7- Envelope call control by NAA is sent to 








UICC 


7- Applet is triggered 






EnvelopeHandler .getTheHandler { ) method is 








called 








8- It is checked that the contents of the 


8- No exception is thrown and the 






envelope handler is the envelope call 


handler contains the envelope call 






control using EnvelopeHandler . copy { ) and 


control by NAA 


A proactive command 




Util . arrayCompare { ) methods 




Display Text is fetched 




The EnvelopeHandler . findTLV{ ) method is 
called with TAG_DEVICE_IDENTITIES 




The terminal Response of 








DISPLAY TEXT is sent to 




Call Control execution is finished. 




the UICC 




9- Check that the TAG_HELP_REQUEST is the 








TLV selected 








10- The contents of EnvelopeHandler are 


10- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare { ) 


in bufferl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Envelope Handler integrity checks with 
EVENT_MENU_SELECTION 








1- An envelope menu selection is sent to 
UICC 


1- Applet is triggered 






2- EnvelopeHandler .getTheHandler { ) method 
is called 


2- No exception is thrown. 






3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 


3- No exception is thrown. 






The EnvelopeHandler . findTLVO method is 
called with TAG_ITEM_IDENTIFIER 








4- A proactive command DISPLAY TEXT is sent 




4- 91 XX 




5- Envelope call control by NAA is sent to 
UICC 


5- Applet is triggered 






EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 






The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 








7- It is checked that the 
TAG_ITEM_IDENTIFIER is the TLV selected 




Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 




8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare { ) 


8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with 
EVENT_TIMER_EXPIRATION 

1- A timer expiration envelope is sent to 
UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_TIMER_ID 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 



7- It is checked that the TAG_TIMER_ID is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



7- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with 
EVENT_CALL_CONTROL_BY_NAA 

1- A call control envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler. findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 



7- It is checked that the TAG_ADDRESS is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_MT_CALL 

1- A event download mt call envelope is 
sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the TAG_EVENT_LIST 
is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_CONNECTED 

1- A event download call connected envelope 
is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



7- It is checked that the TAG_EVENT_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_DISCONNECTED 

1- A event download call disconnected 
envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



7- It is checked that the TAG_EVENT_LIST 
is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_LOCATION_STATUS 

1- A event download location status 
envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_LOCATION_STATUS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_LOCATION_STATUS is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



ETSI 



Release 6 



589 



ETSI TS 102 268 V6.1.0 (2013-06) 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_USER_ACTIVITY 

1- A event download user activity envelope 
is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7-It is checked that the 
TAG_DEVICE_IDENTITIES is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 



The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



10 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOADJDLE_SCREEN_AVAILAB 

LE 

1- A event download idle screen available 
envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_DEVICE_IDENTITIES is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



11 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CARD_READER_STATUS 

1- A event download card reader status 
envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_CARD_READER_STATUS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG DEVICE IDENTITIES 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_CARD_READER_STATUS is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



12 



Envelope Handler integrity checks with 
UNRECOGNIZED_ENVELOPE 

1- A unrecognized envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 

called 

The EnvelopeHandler .getValueLength { ) is 

called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare { ) 



1- Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 
5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



7- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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API/CAT RE Expectation 



APDU Expectation 



13 



Envelope Handler integrity checks with 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SEL 

ECTION 

1- A event download language selection 
envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2-No exception is tlirown. 



3-No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



7- It is checked that the TAG_EVENT_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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API/CAT RE Expectation 



APDU Expectation 



14 



Envelope Handler integrity checks with 

EVENT_EVENT_DOWNLOAD_BROWSER_TERM 

INATION 

1- A event download browser termination 
envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2-No exception is tlirown. 



3-No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



7- It is checked that the TAG_EVENT_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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API/CAT RE Expectation 
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Envelope Handler integrity checks with 
EVENT EVENT DOWNLOAD DATA AVAILABL 

E 








1- The applet builds a proactive command 


1- The applet is registered to 


1- OPEN CHANNEL 




OPEN CHANNEL . 

proactiveHandler . send { ) method is called 


EVENT EVENT DOWNLOAD DA 

TA AVAILABLE and 

EVENT EVENT DOWNLOAD CH 


proactive command is 
fetched 






ANNEL_STATUS 


TERMINAL RESPONSE is 
issued with Channel Id = 01 




2- A event download data available envelope 








is sent to UICC 


2- Applet is triggered 






3- EnvelopeHandler .getTheHandler { ) method 








is called 


3-No exception is thrown. 






4- Copy the contents of the envelope 








handler in buffer 1 using 








EnvelopeHandler . copy { ) 


4-No exception is thrown. 






The EnvelopeHandler . findTLV{ ) method is 








called with TAG_CHANNEL_STATUS 








5- A proactive command DISPLAY TEXT is sent 








6- Envelope call control by NAA is sent to 




5-91 XX 




UICC 








EnvelopeHandler .getTheHandler { ) method is 


6- Applet is triggered 






called 








7- It is checked that the contents of the 
envelope handler is the envelope call 


7- No exception is thrown and the 






control using EnvelopeHandler . copy { ) and 


handler contains the envelope call 






Util . arrayCompare { ) methods 


control by NAA 






The EnvelopeHandler . findTLV{ ) method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




8- It is checked that the 
TAG_CHANNEL_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 




9- The contents of EnvelopeHandler are 


9- The contents of the envelope 






compared with bufferl using 


handler shall be the same as stored 






Util . arrayCompare { ) 


in bufferl 
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API/CAT RE Expectation 
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16 


Envelope Handler integrity checks with 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 








1- A event download channel status envelope 
is sent to UICC 


1- Applet is triggered 






2- EnvelopeHandler .getTheHandler { ) method 
is called 


2-No exception is tlirown. 






3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 


3-No exception is thrown. 






The EnvelopeHandler . findTLV{ ) method is 
called with TAG_CHANNEL_STATUS 








4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 




4-91 XX 




UICC 


5- Applet is triggered 






EnvelopeHandler .getTheHandler { ) method is 
called 








6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 






The EnvelopeHandler . findTLV{ ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




7- It is checked that the 
TAG_CHANNEL_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 




8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare { ) 


8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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API/CAT RE Expectation 
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17 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_ 

CHANGE 

1- A event download access technology 
change envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_ACCESS_TECHNOLOGY 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_ACCESS_TECHNOLOGY is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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18 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOAD_DISPLAY_PARAMETER_C 

HANGED 

1- A event download display parameter 
changed envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_DISPLAY_PARAMETER 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_DISPLAY_PARAMETER is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 

9- Applet sends a DECLARE 
SERVICE (add) proactive 
command with its service identifier 



9- DECLARE SERVICE 
(add) proactive command is 
fetched 

Successful TERIVIINAL 
RESPONSE is issued 
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Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_LOCAL_CONNECTION 

1- A event download local connection 
envelope is sent to UICC with the allocated 
service Id of Applet 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_SERVICE_RECORD 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the 
TAG_SERVICE_RECORD is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOAD_NETWORK_SEARCH_MO 

DE_CHANGE 

1- A event download network search mode 
change envelope is sent to UICC 

2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_NETWORK_SEARCH_MODE 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



7-It is checked that the 
TAG_NETWORK_SEARCH_MODE is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare { ) 



4- 91 XX 



Proactive command Display 
Text is fetched 



The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 
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Envelope Handler integrity checks with EVENT 
EVENT_DOWNLOAD_BROWSING STATUS 








1- A event download browsing status 
envelope is sent to UICC 


1- Applet is triggered 






2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 


2- No exception is thrown. 

3- No exception is thrown. 






The EnvelopeHandler . findTLVO method is 
called with TAG_BROWSING_STATUS 








4- A proactive command DISPLAY TEXT is sent 








5- Envelope call control by NAA is sent to 
UICC 




4- 91 XX 




EnvelopeHandler .getTheHandler { ) method is 
called 


5- Applet is triggered 






6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 






The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished 




Proactive command Display 
Text is fetched 




7- It is checked that the 
TAG_BROWSING_STATUS is the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 


8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 


The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Envelope Handler integrity checks with EVENT_ 
EXTERNAL FILE UPDATE under MF 



EFt. 



of the UICC file system is updated 



2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_FILE_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler. findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the TAG_FILE_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



9- It is checked that the EnvelopeHandler 
contains the comprehension TLVs : Device 
Identity, File List and File Update 
Information with the correct value. 
The EnvelopeHandler does not contain the 
comprehension TLV AID 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 
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Envelope Handler integrity checks with EVENT_ 
EXTERNAL FILE UPDATE under ADF 



EFk 



of the ADF file system is updated 



2- EnvelopeHandler .getTheHandler { ) method 
is called 

3- Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy { ) 

The EnvelopeHandler . findTLVO method is 
called with TAG_FILE_LIST 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by NAA is sent to 
UICC 

EnvelopeHandler .getTheHandler { ) method is 
called 

6- It is checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy { ) and 
Util . arrayCompare { ) methods 

The EnvelopeHandler. findTLVO method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



7- It is checked that the TAG_FILE_LIST is 
the TLV selected 

8- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare { ) 



9- It is checked that the EnvelopeHandler 
contains the comprehension TLVs : Device 
Identity, File List, AID and File Update 
Information with the correct value. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by NAA 



4- 91 XX 



8- The contents of the envelope 
handler shall be the same as stored 
in bufferl 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the UICC 



5.5.2.4 EnvelopeResponseHandler 

Test Area Reference: Cre_Hin_Erhd. 

5.5.2.4.1 Conformance requirement 

5.5.2.4.1.1 Normal execution 

• CRRNl: At the processToolkit invocation the TLV-List is cleared. 

5.5.2.4.1 .2 Parameter errors 
No requirements. 
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5.5.2.4.1.3 

No requirements. 

5.5.2.4.2 

Test Source: 
Test Applet: 
Cap_File: 

5.5.2.4.3 



5.5.2.4.4 



Context errors 
Test area files 

Test_Cre_Hin_Erhd.j ava. 
Cre_Hin_Erhd_ 1 .j a va . 
Cre_Hin_Erhd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


At the processToolkit invocation the TLV-List is 
cleared 

Appletl is registered to 
EVENT_UNRECOGNIZED_ENVELOPE . 

1-An unrecognized envelope is sent to the 
UICC 

2- EnvelopeResponseHandler .getTheHandler { ) is 
called by the Appletl. 

3- EnvelopeResponseHandler .getLength { ) 
method is called by Appletl 


1- Appletl is triggered 

3- The return value shall be 





5.5.3 Applet Triggering 
5.5.3.1 General behaviour 

Test Area Reference: Cre_Apt_Genb. 

5.5.3.1.1 Conformance requirement 

5.5.3.1 .1 .1 Normal execution 

• CRRNl: When a first level application is the selected application and when a Toolkit Applet is triggered the 
selecti} method of the Toolkit Applet shall not be launched since the Toolkit Applet itself is not selected. 

• CRRN2: The CAT Runtime Environment shall only trigger a Toolkit Applet if it is in the selectable state as 
defined in TS 102 226 [8]. 

• CRRN3: When the CAT Runtime Environment has to trigger several applets on the same event, the next 
applet is triggered on the return of the processToolkit() method of the previous Toolkit Applet. 



5.5.3.1.1.2 

No requirements. 

5.5.3.1.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.3.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.1.3 



Test area files 

Test_Cre_Apt_Genb.java. 
Cre_Apt_Genb_ 1 .j ava. 
cre_apt_genb . c ap . 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


Covered by all other tests of this clause (5.5.3) 


CRRN2 


1,2,3,4 


CRRN3 


Covered by all other tests of this clause (5.5.3) 



5.5.3.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Triggering an applet in the installed state 

when installed, the applet is registered 
to EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Install the applet without making it 
selectable 

2- Select the Applet by AID 

3- An envelope event download user 
activity is sent to the UICC 


2- Applet is not triggered 


1 - SW = 90 00 
2- SW ^ 90 00 


2 


Triggering an applet in the make selectable 
state 

1- Install the applet to make it 
selectable 

2- Select the Applet by AID3- An envelope 
event download user activity is sent to 
the UICC 


2- Applet is triggered 


1 - SW = 90 00 
2- SW = 90 00 


3 


Triggering an applet in the lock state 

1- Set the applet in the lock state 

2- Select the Applet by AID 3- An envelope 
event download user activity is sent to 
the UICC 


2- Applet is not triggered 


1 - SW = 90 00 
2- SW 5^ 90 00 


4 


Triggering an applet in the make selectable 
state 

1- Set the applet in the make selectable 
state 

2- Select the Applet by AID 3- An envelope 
event download user activity is sent to 
the UICC 


2- Applet is triggered 


1 - SW = 90 00 
2- SW = 90 00 



5.5.3.2 EVENT_PROFILE_DOWNLOAD 

Test Area Reference: Cre_Apt_Epdw. 

5.5.3.2.1 Conformance requirement 

5.5.3.2.1.1 Normal execution 

• CRRN 1 : Upon reception of a TERMINAL PROFILE APDU command the CAT Runtime Environment shall 
store the terminal profile and trigger all the Toolkit Applet(s) registered to this event. 
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• CRRN2: The applet is not triggered by the EVENT_PROFILE_DOWNLOAD once it has deregistered from 
this event. 

• CRRN3: The CAT Runtime Environment shall not reply busy to a Terminal Profile command. 

5.5.3.2.1 .2 Parameter errors 
No requirements. 

5.5.3.2.1.3 Context errors 
No requirements. 

5.5.3.2.2 Test area files 

Test Source: Test_Cre_Apt_Epdw.java. 
Test Applet: Cre_Apt_Epdw_l.java. 

Cre_Apt_Epdw_2.j ava. 

Cre_Apt_Epdw_3 .j ava. 

Cre_apt_epdw. cap . 



Cap_File: 
5.5.3.2.3 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


3 


CRRN3 


2 



5.5.3.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_PROFILE_DOWNLOAD and triggering 

Appletl is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applet2 is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applets is not registered to the 

EVENT PROFILE DOWNLOAD and is registered 

to EVENT_MENU_SELECTION. 








1-Terminal Profile command is sent to UICC 


1- Appletl is triggered 

Appletl finalizes 

2- Applet2 is triggered 

Applet2 finalizes 

3- Applet3 is not triggered 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



The CAT Runtime Environment shall not reply 
busy to a Terminal Profile command 

l-Envelope menu selection is sent to the 
UICC 

Applets builds a REFRESH proactive command 
in UICC initialization mode 

2-ProactiveHandler . send { ) method is called 
by applets 



3 -Terminal Profile command is sent to the 
UICC 

Appletl calls ToolkitRegistry . clearEvent { 
EVENT PROFILE DOWNLOAD) 



4-Applet2 calls 
ToolkitRegistry. clearEvent { 
EVENT PROFILE DOWNLOAD) 



6-Applet3 calls 

ToolkitRegistry . setEvent {EVENT_PROFILE_DOW 

NLOAD ) 



1 - Applets is triggered by the 
EVENT IVIENU SELECTION 



Applets is suspended until the 
terminal response 



3- Appletl is triggered by 
EVENT PROFILE DOWNLOAD 



Appletl finalizes 

Applet2 is triggered by 

EVENT PROFILE DOWNLOAD 



Applet2 finalizes 



Applets finalizes 



2- A proactive command is 
sent 



5- The terminal response of 
the proactive command is 
sent 



Deregistered applets are not triggered 

Terminal Profile command is sent to the 
UICC 



Applets is triggered 
(Appletl and Applet2 are not 
triggered) 



5.5.3.3 EVENT_MENU_SELECTION 

Test Area Reference: Cre_Apt_Emse. 

5.5.3.3.1 Conformance requirement 

5.5.3.3.1.1 Normal execution 

• CRRN 1 : Upon reception of an ENVELOPE (MENU SELECTION) APDU command, the CAT Runtime 
Environment shall only trigger the Toolkit Applet registered to the corresponding event with the associated 
menu identifier. 



5.5.3.3.1.2 

No requirements. 

5.5.3.3.1.3 

No requirements. 



Parameter errors 



Context errors 



ETSI 



Release 6 



608 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.5.3.3.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.3.3.3 



Test area files 

Test_Cre_Apt_Emse.java. 
Cre_Apt_Emse_ 1 .j ava. 
Cre_Apt_Emse_2 .j ava. 
Cre_apt_emse.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



5.5.3.3.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 
EVENT_l\/IENU_SELECTION and triggering 

ToolkitRegistry . initMenuEntry { ) method is 
called at the installation of Appletl and 
Applet2 

For Appletl : 
MenuEntry= "Appletl " 
Offset=0 

Length=menuEntry . length 
He lpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

For Applet2 : 
MenuEntry= " Applet2 " 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION 
1-ToolkitRegistry . isEventSet { ) is called 
at installation. 

Perform UICC initialization with the 
facility SET UP MENU and without the 
facilities SET EVENT LIST and POLL 
INTERVAL features 

2-Item Identifier = 1 

Event Menu Selection envelope is sent to 
the UICC with the item identifier of a 
menu entry of Appletl 



3-Item Identifier = 2 

Event Menu Selection envelope is sent to 
the UICC with the item identifier of a 
menu entry of Applet2 



1 - The method shall return true 



2- Appletl is triggered and Applet2 
is not triggered 



Appletl finalizes 

3- Applet2 is triggered and Appletl 
is not triggered 
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5.5.3.4 EVENT_MENU_SELECTION_HELP_REQUEST 

Test Area Reference: Cre_Apt_Emsh. 

5.5.3.4.1 Conformance requirement 

5.5.3.4.1.1 Normal execution 

• CRRN 1 : If an ENVELOPE (MENU_SELECTION_HELP_SUPPORTED) command is received for one entry 
supporting help, then CAT Runtime Environment shall trigger the corresponding applet. 

• CCRN2: A toolkit applet shall be triggered by the EVENT_MENU_SELECTION_HELP_REQUEST event 
only if the Menu Id corresponding to the Envelope Menu Selection Help Request received by the CAT 
Runtime Environment was registered with the helpSupported value set to true. 

• CCRN3: If at least one menuld of a Toolkit Applet registers to 
EVENT_MENU_SELECTION_HELP_REQUEST, the SET UP MENU proactive command sent by the CAT 
Runtime Environment shall indicate to the ME that help information is available unless all the menus entries 
that support help are disabled. 



5.5.3.4.1.2 

No requirements. 

5.5.3.4.1.3 

No requirements. 

5.5.3.4.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.3.4.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Emsh.j ava. 
Cre_Apt_Emsh_l .Java. 
Cre_Apt_Emsh_2.j ava. 
Cre_Apt_Emsh_3 .j ava. 
Cre_apt_emsh.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1 


CRRN3 


2 
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5.5.3.4.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 

EVENT_MENU_SELECTION_HELP_REQUEST 

and triggering 

Appletl and Applet2 are installed 

ToolkitRegistry . InitMenuEntry { ) method is 
called at the installation of Appletl and 
Applet2 

For Appletl {item id 1) : 
MenuEntry="AppletlA" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Appletl {item id 2) : 
MenuEntry=" Applet IB" 
Offset=0 

Length=menuEntry . length 
He lpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION_HELP_REQUEST 

1- ToolkitRegistry . isEventSet { ) is called 
at the installation 

For Applet2 {item id 3) : 
MenuEntry= " Applet2A" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applet2 {item id 4) : 
MenuEntry="Applet2B" 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

event = EVENT_MENU_SELECTION_HELP_REQUEST 

2- ToolkitRegistry . isEventSet { ) is called 
at installation 

Perform UICC initialization with the 
facility SET UP MENU and without the 
facilities SET EVENT LIST and POLL 
INTERVAL 

3-Item identifier = 1 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 1 
belonging to Appletl 

4-Item identifier = 2 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 2 
belonging to Appletl 

5-Item identifier = 3 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 3 
belonging to Applet2 

6-Item identifier = 4 

Menu Selection Help Request envelope is 
sent to the UICC with item identifier 4 
belonging to Applet2 



1 - The command shall return true 



2- The command shall return true 



3- Appletl is triggered and Applet2 
is not triggered 



4 Appletl and Applet2 are not 
triggered 



5- Applet2 is triggered and Appletl 
is not triggered 



6- Applet2 and Appletl are not 
triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration to 
EVENT_MENU_SELECTION_HELP_REQUEST 

Appletl and Applet2 are deleted 

Applets is installed 

ToolkitRegistry . InitMenuEntry { ) method is 
called at the installation of Applets 

For Applets {item id 5) : 
MenuEntry="Applet3A" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applets {item id 6) : 
MenuEntry=" Apple t3B" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applet3 {item id 7) : 
MenuEntry=" Applet 3C" 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 




1- The UICC shall issue a 




1- Perform UICC initialization with the 
facility SET UP MENU and without the 
facilities SET EVENT LIST and POLL 
INTERVAL 




SET UP MENU proactive 
command with Menu Entry 
ID entry '05', '06' and '07', 
and Help supported set to 
true. 




2- Menu Selection Help Request envelope is 


2- Applets is triggered by 






sent to the UICC with item identifier 5 


EVENT MENU SELECTION HEL 






belonging to applets 


P_REQUEST 






3- ToolkitRegistry .disableMenuEntry{ ) 
method for item id 5 is called by the Menu 
Selection Help Request Envelope. 




S- The UICC shall issue a 
SET UP MENU proactive 
command with Menu Entry 
ID entry '06' and '07', and 
Help supported set to true. 




4- Menu Selection Help Request envelope is 
sent to the UICC with item identifier 6 
belonging to applets 


4- Applets is triggered by 

EVENT MENU SELECTION HEL 

P REOUEST 






5- ToolkitRegistry .disableMenuEntry{ ) 
method for item id 6 is called by the Menu 




5- The UICC shall issue a 




Selection Help Request Envelope 




SET UP MENU proactive 
command with Menu Entry 
ID entry '07', and Help 
supported set to false 
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5.5.3.5 EVENT_CALL_CONTROL_BY_NAA 

Test Area Reference: Cre_Apt_Eccn. 

5.5.3.5.1 Conformance requirement 

5.5.3.5.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_CALL_CONTROL_B Y_N AA once it has registered to this 
event and an Envelope Call Control by NAA is received. 

• CRRN2: The applet is not triggered by the EVENT_CALL_CONTROL_BY_NAA once it has deregistered 
from this event. 

• CRRN3: Regardless of the Toolkit Applet state the CAT Runtime Environment shall not allow more than one 
Toolkit Applet to be registered to this event at a time. 



5.5.3.5.1.2 

No requirements. 

5.5.3.5.1.3 

No requirements. 

5.5.3.5.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.3.5.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_APT_ECCN.java. 
Cre_Apt_Eccn_l .Java. 
Cre_Apt_Eccn_2.j ava. 
Cre_apt_eccn . c ap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 


CRRN3 


See API 2 TKR SEVTB 
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5.5.3.5.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 

EVENT_CALL_CONTROL_BY_NAA and 

triggering 

Appletl is registered to 
EVENT_CALL_CONTROL_BY_NAA . 

Applet2 is registered to 
EVENT_MENU_SELECTION 

1- An Envelope Call control by NAA is sent 
to the UICC 


1- Appletl is triggered 




2 


Applet deregistration and registration of the 

second applet to 

EVENT_CALL_CONTROL_BY_NAA. 

1- An Envelope menu selection is sent to 
the UICC 

Applet2 contracts a Display Text proactive 
command. 

2- ProactiveHandler . send { ) method is 
called 

3- An Envelope Call control by NAA 
envelope is sent to the UICC 

ToolkitRegistry . clearEvent { ) is called for 
EVENT_CALL_CONTROL_BY_NAA 

4- TERMINAL RESPONSE of Display Text is 
sent to the UICC 

ToolkitRegistry . setEvent { ) method is 
called for EVENT_CALL_CONTROL_BY_NAA 


1 - Applet2 is triggered by 
EVENT_MENU_SELECTION. 

3- Appletl is triggered 

Appletl finalizes. 

4- Applet2 is resumed 

Applet2 finalizes 


2- A proactive command 
Display Text is sent and 
applet is suspended until 
the terminal response 


3 


Applet triggering 

An Envelope Call control by NAA envelope 
is sent to the UICC 


Applet2 is triggered. 
(Appletl is not triggered) 





5.5.3.6 EVENT_TIMER_EXPIRATION 

Test Area Reference: Cre_Apt_Etex. 

5.5.3.6.1 Conformance requirement 

5.5.3.6.1.1 Normal execution 

• CRRNl : The applet is triggered by the EVENT_TIMER_EXPIRATION once it has been registered to this 
event and an Envelope Timer Expiration with a Timer Identifier of the applet is received if no proactive 
session is ongoing. 

• CRRN2: The applet is not triggered by the EVENT_TIMER_EXPIRATION once it has been deregistered 
from this event. 



5.5.3.6.1.2 

No requirements. 



Parameter errors 
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5.5.3.6.1.3 

No requirements. 

5.5.3.6.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.6.3 



Context errors 
Test area files 

Test_Cre_Apt_Etex.j ava. 
Cre_ Apt_Etex_ 1 .j a va . 
Cre_apt_etex. cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.6.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_TIMER_EXPIRATION and 

triggering 

Applet is registered to the 
EVENT_TIMER_EXPIRATION using the 
allocateTimer { ) method and to 
EVENT_MENU_SELECTION . 

event= EVENT_TIMER_EXPIRATION 

1- ToolkitRegistry . isEventSet { ) 
method is called. 

2- An Envelope TIMER_EXPIRATION is 
sent to the UICC. 


1 - The method returns true 
2- Applet is triggered. 




2 


Applet deregistration 

Timer id=l 

ToolkitRegistry .ReleaseTimer { ) method 

is called 

1- An Envelope timer expiration is 
sent to the UICC 

An Envelope Menu selection is sent to 
the UICC 

ToolkitRegistry .AllocateTimer { ) 
method is called 

2- An Envelope TIMER_EXPIRATION is 
sent to the UICC 


1 - Applet is not triggered 
2- Applet is triggered 





5.5.3.7 EVENT_EVENT_DOWNLOAD_MT_CALL 

Test Area Reference: Cre_Apt_Edmc. 

5.5.3.7.1 Conformance requirement 

5.5.3.7.1.1 Normal execution 

• CRRNl : The applet is triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has registered to 
this event and an Envelope Event DownLoad MT Call is received. 
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• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has 
deregistered from this event. 



5.5.3.7.1.2 

No requirements. 

5.5.3.7.1.3 

No requirements. 

5.5.3.7.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.7.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edmc.j ava. 
Cre_Apt_Edmc_l .Java. 
cre_apt_edmc.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.7.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_MT_CALL and 

triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_MT_CALL and to 
EVENT_MENU_SELECTION 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 
1-ToolkitRegistry. isEventSet { ) method is 
called 

2 -An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the UICC 


1 - The method returns true 
2- Applet is triggered 




2 


Applet deregistration 

event = EVENT_EVENT_DOWNLOAD_iy!T_CALL 
ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the UICC 

An Envelope menu selestion is sent to the 
UICC 

event = EVENT_EVENT_DOWNLOAD_MT_CALL 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the UICC 


1- Applet is not triggered 
2- Applet is triggered 
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5.5.3.8 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

Test Area Reference: Cre_Apt_Edcc. 

5.5.3.8.1 Conformance requirement 

5.5.3.8.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_C ALL_CONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Connected is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it 
has deregistered from this event. 



5.5.3.8.1.2 

No requirements. 

5.5.3.8.1.3 

No requirements. 

5.5.3.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.8.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcc.j ava. 
Cre_Apt_Edcc_ 1 .j ava. 
Cre_apt_edcc.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.8.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CALL_CONNECT 

ED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED and to 
EVENT_MENU_SELECTION 

event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

event = EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
ToolkitRegistry . clearEvent { ) method is 
called 

1-A call connected event dowload is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the UICC 


1- Applet is not triggered 
2- Applet is triggered 





5.5.3.9 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Test Area Reference: Cre_Apt_Edcd. 
5.5.3.9.1 



5.5.3.9.1.1 



Conformance requirement 



Normal execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_C ALL_DISCONNECTED once it 
has registered to this event and an Envelope Event DownLoad Call Disconnected is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once 
it has deregistered from this event. 



5.5.3.9.1.2 

No requirements. 

5.5.3.9.1.3 

No requirements. 



Parameter errors 



Context errors 
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5.5.3.9.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.9.3 



Test area files 

Test_Cre_Apt_Edcd.j ava. 
Cre_Apt_Edcd_ 1 .j ava. 
Cre_apt_edcd.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.9.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CALL_DISCONN 

ECTED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED and 
to EVENT_MENU_SELECTION 

Event =EVENT_EVENT_DOWNLOAD_CALL_DISCONNECT 

ED 

1-ToolkitRegistry . isEventSet { ) method is 

called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_D I S CONNECTED i s 
sent to the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

Event = 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope 

EVENT_DOWNLOAD_CALL_DISCONNECTED is sent 
to the UICC 

An envelope menu selection is sent to the 
UICC 

Event = 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
ToolkitRegistry. setEvent { ) method is 
called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the UICC 


1- Applet is not triggered 
2- Applet is triggered 
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5.5.3.1 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Test Area Reference: Cre_Apt_Edls. 

5.5.3.10.1 Conformance requirement 

5.5.3.10.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_LOC ATION_STATUS once it has 
registered to this event and an Envelope Event DownLoad Location Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it 
has deregistered from this event. 



5.5.3.10.1.2 
No requirements. 

5.5.3.10.1.3 
No requirements. 

5.5.3.10.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.10.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edls.java. 
Cre_Apt_Edls_ 1 .j ava. 
Cre_apt_edls.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.10.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_LOACTION_STA 

TUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
to EVENT_MENU_SELECTION 

Event = EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS is 
sent to the UICC 


1 - Method returns true 
2- Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event = EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope 

EVENT DOWNLOAD LOCATION STATUS is sent to 

the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the UICC 


1 - Applet is not triggered 
2- Applet is triggered 





5.5.3.1 1 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

Test Area Reference: Cre_Apt_Edua 

5.5.3.1 1.1 Conformance requirement 

5.5.3.1 1.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_USER_ACTIVITY once it has 
registered to this event and an Envelope Event DownLoad User Activity is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
deregistered from this event. 



5.5.3.11.1.2 
No requirements. 

5.5.3.11.1.3 
No requirements. 

5.5.3.11.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.11.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edua.j ava. 
Cre_Apt_Edua_ 1 .j ava. 
Cre_apt_edua.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.11.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and to 
EVENT_MENU_SELECTION 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the UICC 


1- Applet is not triggered 
2- Applet is triggered 





5.5.3.12 EVENT_EVENT_DOWNLOADJDLE_SCREEN_AVAILABLE 

Test Area Reference: Cre_Apt_Edis. 

5.5.3.12.1 Conformance requirement 

5.5.3.12.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
once it has registered to this event and an Envelope Event DownLoad Idle Screen Available is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
once it has deregistered from this event. 



5.5.3.12.1.2 
No requirements. 

5.5.3.12.1.3 
No requirements. 

5.5.3.12.2 

Test Source: 
Test Applet: 
Cap File: 



Parameter errors 
Context errors 
Test area files 

Te s t_Cre_ Apt_Edi s .j a va . 
Cre_Apt_Edis_ 1 .j ava. 
Cre_apt_edi s . c ap . 
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5.5.3.12.3 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.12.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOADJDLE_SCREEN_ 

AVAILABLE and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_I DLE_S CREEN_AVAI LABLE 
and to EVENT_MENU_SELECTION 
Event = 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
1-ToolkitRegistry . isEventSet { ) method is 
called 

2- An Envelope 

EVENT_DOWNLOAD_I DLE_S CREEN_AVAI LABLE i s 

sent to the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

Event = EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA 
ILABLE 

ToolkitRegistry . clearEvent { ) method is 
called 

1- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the UICC 


1- Applet is not triggered 
2- Applet is triggered 





5.5.3.13 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Test Area Reference: Cre_Apt_Edcr. 

5.5.3.13.1 Conformance requirement 

5.5.3.13.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_C ARD_READER_STATUS once it 
has registered to this event and Envelope Event DownLoad Card Reader Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
once it has deregistered from this event. 
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5.5.3.13.1.2 
No requirements. 

5.5.3.13.1.3 
No requirements. 

5.5.3.13.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.13.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcr.j ava. 
Cre_Apt_Edcr_ 1 .j ava. 
Cre_apt_edcr.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.13.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CARD_READER 

_STATUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
and to EVENT_MENU_SELECTION 

Event=EVENT EVENT DOWNLOAD CARD READER STA 

TUS 

1-ToolkitRegistry . isEventSet { ) method is 

called. 

2- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

Event = 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the UICC 


1 - Applet is not triggered 
2- Applet is triggered 
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5.5.3.14 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: Cre_Apt_Euev. 

5.5.3.14.1 Conformance requirement 

5.5.3.14.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has registered to this 
event and an Unrecognized Envelope is received. 

• CRRN2: The applet is not triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has deregistered 
from this event. 



5.5.3.14.1.2 
No requirements. 

5.5.3.14.1.3 
No requirements. 

5.5.3.14.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.14.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Euen.j ava. 
Cre_Apt_Euen_ 1 .j ava. 
Cre_apt_euen.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.14.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_UNRECOGNIZED_ENVELOPE and 

triggering 

Applet is registered to the 
EVENT_UNRECOGNIZED_ENVELOPE 
Event= EVENT_UNRECOGNIZED_ENVELOPE 
1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the UICC 


1 - Method returns true 
2- Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event = EVENT_UNRECOGNIZED_ENVELOPE 
ToolkitRegistry . clearEvent { ) method is 
called 








1-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the UICC 


1- Applet is not triggered 






An Envelope menu selection is sent to the 








UICC 








Event= EVENT UNRECOGNIZED ENVELOPE 








ToolkitRegistry . setEvent { ) method is 








called 








2 -An Envelope UNRECOGNIZED ENVELOPE is 


2- Applet is triggered 






sent to the UICC 







5.5.3.15 EVENT_STATUS_COMMAND 

Test Area Reference: Cre_Apt_Estc. 

5.5.3.15.1 Conformance requirement 

5.5.3.15.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_STATUS_COMM AND once it has registered to this event 
and a Status Command is received. 

• CRRN2: The applet is not triggered by the EVENT_STATUS_COMMAND once it has deregistered from this 
event. 



5.5.3.15.1.2 
No requirements. 

5.5.3.15.1.3 
No requirements. 

5.5.3.15.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.3.15.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Estc.j ava. 
Cre_Apt_Estc_l .Java. 
Cre_Apt_Estc_2 .j ava. 
Cre_Apt_Estc_3 .j ava. 
Cre_apt_estc.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 
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5.5.3.15.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_STATUS_COMMAND and triggering 

Appletl is registered to 
EVENT_STATUS_COMMAND using the 
requestPollInterval { ) command 

Applet2 is registered to 
EVENT_STATUS_COMMAND using the 
RequestPollInterval { ) command 

Applets is registered to 
EVENT_MENU_SELECTION . 

1-A status command is sent to UICC 


1- Appletl is triggered. 
Appletl finalizes 

2- Applet2 is triggered. 
Applet2 finalizes 

3- Applets is not triggered 




2 


Applet deregistration and registration of the 
third applet to EVENT_STATUS_COMMAND. 

1- An Envelope menu selection is sent to 
UICC 

Applets builds a Display Text. 

2- ProactiveHandler . send { ) is called 

3- A status command is sent to UICC 

4- requestPollInterval { ) method with 
POLL_NO_DURATION is called 

5- requestPollInterval { ) method with 
POLL_NO_DURATION is called 

S- TERMINAL RESPONSE of Display Text is 
sent to the UICC 

7- requestPollInterval { ) method is called 


1- Applets is triggered. 

3- Appletl is triggered. 

4- Appletl is deregistered to 
EVENT_STATUS_COMMAND 

Appletl finalizes 
Applet2 is triggered. 

5- Applet2 is deregistered to 
EVENT_STATUS_COMMAND 

Applet2 finalizes 

6- Applets is resumed 

7- Applets is registered to 
EVENT_STATUS_COMMAND 

Applets finalizes 


2- A proactive command 
Display Text is sent and 
applet is suspended until 
the terminal response 


3 


Applets triggering 

status command is sent to UICC 


Applets is triggered. 
(Appletl and Applet2 are not 
triggered) 
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5.5.3.16 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

Test Area Reference: Cre_Apt_Edlg. 

5.5.3.16.1 Conformance requirement 

5.5.3.16.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_LANGU AGE_SELECTION once it 
has registered to this event and an Envelope Event DownLoad Language Selection is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
once it has deregistered from this event. 



5.5.3.16.1.2 
No requirements. 

5.5.3.16.1.3 
No requirements. 

5.5.3.16.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.16.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edlg.j ava. 
Cre_ Apt_Edlg_ 1 .j a va . 
Cre_apt_edlg.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.16.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SE 

LECTION and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
and to EVENT_MENU_SELECTION. 

Event = 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope 

EVENT DOWNLOAD LANGUAGE SELECTION is sent 

to the UICC 


1 -Method returns true 
2- Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event = 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the UICC 


1- Applet is not triggered 
2- Applet is triggered 





5.5.3.1 7 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

Test Area Reference: Cre_Apt_Edbt. 

5.5.3.17.1 Conformance requirement 

5.5.3.17.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_BROWSER_TERMINATION once 
it has registered to this event and an Envelope Event DownLoad Browser Termination is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
once it has deregistered from this event. 



5.5.3.17.1.2 
No requirements. 

5.5.3.17.1.3 
No requirements. 

5.5.3.17.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.17.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edbt.j ava. 
Cre_Apt_Edbt_ 1 .j ava. 
Cre_apt_edbt.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.17.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD 

BROWSER_TERMINATION and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
and to EVENT_MENU_SELECTION 

Event = 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the UICC 


1 -Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

Event = 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
ToolkitRegistry . clearEvent { ) method is 
called 

1-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the UICC 


1- Applet is not triggered 
2- Applet is triggered 





5.5.3.1 8 EVENT_FIRST_COMMAND_AFTER_ATR 

Test Area Reference: Cre_Apt_Efca. 

5.5.3.18.1 Conformance requirement 

5.5.3.18.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_FIRST_COMMAND_AFTER_ATR once it has registered to 
this event and upon the reception of the first APDU after the ATR, before the Status Word of the processed 
command has been sent back by the UICC. 

• CRRN2: The applet is not triggered by the EVENT_FIRST_COMMAND_AFTER_ATR once it has 
deregistered from this event. 

• CRRN3: If the first APDU received is a toolkit applet triggering APDU (e.g. TERMINAL PROFILE), the 
toolkit applets registered to the EVENT_FIRST_COMMAND_AFTER_ATR event shall be triggered first. 



5.5.3.18.1.2 
No requirements. 



Parameter errors 
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5.5.3.18.1.3 
No requirements. 

5.5.3.18.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.3.18.3 



Context errors 
Test area files 

Test_Cre_Apt_Efca.j ava. 
Cre_Apt_Efca_l .Java. 
Cre_Apt_Efca_2.java. 
Cre_Apt_Efca_3 .j ava. 
Cre_Apt_Efca_4.j ava. 
Cre_Apt_Efca_5 .j ava. 
Cre_apt_efca.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2,3,4 


CRRN2 


3 


CRRN3 


1,4 



5.5.3.18.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets registration to 

EVENT_FIRST_COMMAND_AFTER_ATRand 

triggering 

Appletl is registered to the 
EVENT_F I RST_COMMAND_AFTER_ATR 

Applet2 is registered to the 
EVENT_PROF I LE_DOWNLOAD 

Applets is registered to 
EVENT_MENU_SELECTION 

1- Terminal Profile command is sent to the 
UICC 

2- Appletl deregisters from 
EVENT_F I RST_COMMAND_AFTER_ATR 

3- Applet2 deregisters from 
EVENT^PROF I LE_DOWNLOAD 

4- An Envelope menu selection is sent to 
the UICC 

5- Applets calls setEvent { ) on event 
EVENT FIRST COMMAND AFTER ATR 


1- Appletl is triggered by 

EVENT FIRST COMMAND Ah 1 b 

R_ATR 

Appletl finalizes 

Applet2 is triggered by 

EVENT_PROFILE_DOWNLOAD 

Applet2 finalizes 
Applet3 is not triggered 

4- Applet3 is triggered. 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Deregistered applets are not triggered 

l-Reset then Terminal Profile command is 
sent to the UICC 

2-Applet3 calls setEventO on 
EVENT PROFILE DOWNLOAD 


1 -Applets is triggered 
Appletl and Applet2 are not 
triggered 

2-Applet3 finalizes 




3 


Install a 4'" applet registered to 

EVENT FIRST COMMAND AFTER ATR and 

EVENT_PROFILE_DOWNLOAD 

Applet4 is installed, with the same 
priority level as Applets 

l-Reset then Terminal Profile command is 
sent to the UICC 

2- Delete all applets 


1 - Applet4 is triggered by 

EVENT FIRST COMMAND Ah 1 b 

R_ATR 

Applet4 finalizes 

Applets is triggered by 

EVENT FIRST COMMAND AFTE 

R_ATR 

Applets finalizes 

Applet4 is triggered by 
EVENT_PROFILE DOWNLOAD 

Applet4 finalizes 

Applets is triggered by 
EVENT_PROFILE_DOWNLOAD 

Applets finalizes 




4 


Check that the applet is triggered before the 
first status word is sent 

1- Install Applets 

Applets is registered with two entries in 
the menu entries list 
Applets is also registered to 
EVENT_F I RST_COMiyiAND_AFTER_ATR 

2- Reset then Terminal Profile command is 
sent to the UICC 

3- Applets disables a menu entry 


2- Applets is triggered 


S-Tfie SETUP MENU 

proactive command is 

fetchied. 

There is only one item for 

Applets 



5.5.3.19 EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

Test Area Reference: Cre_Apt_Edda. 

5.5.3.19.1 Conformance requirement 

5.5.3.19.1.1 Normal execution 

• CRRN 1 : For EVENT_EVENT_DOWNLOAD_D AT A_ AVAILABLE, the framework shall only trigger the 
applet registered to this event with the appropriate channel identifier. 
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CRRN2: The registration to the EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE is effective once the 
toolkit applet has issued a successful OPEN CHANNEL proactive command, and valid till the first successful 
CLOSE CHANNEL or the end of card session. 

CRRN3: When a Toolkit Applet has sent an OPEN CHANNEL proactive command and received a successful 
TERMINAL RESPONSE with General Result ="OxOX", the framework shall register the received channel 
identifier for the calling Toolkit Applet. 

CRRN4: When a Toolkit Applet has sent a CLOSE CHANNEL proactive command and received a successful 
TERMINAL RESPONSE with General Result ="OxOX", the framework shall release the channel identifier 
contained in the command. 



5.5.3.19.1.2 
No requirements. 

5.5.3.19.1.3 
No requirements. 

5.5.3.19.2 

Test Applet: 
Test Applet: 
Cap File: 

5.5.3.19.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edda.j ava. 
Cre_Apt_Edda_ 1 .j ava. 
Cre_apt_edda.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


2 


CRRN2 


1,4,5 


CRRN3 


1 


CRRN4 


3 
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5.5.3.19.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 

EVENT_EVENT_DOWNLOAD_DATA_AVAILAB 

LE 



Appletl is registered to Event Menu 

selection. 

1- An Envelope menu selection is sent to 

the UICC 



2- Applet calls setEventO with the event 
EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE 

3- An envelope Event Download Data 
Available is sent to the UICC 
Channel Status = 81 00 

4- An Envelope menu selection is sent to 
the UICC 

5- Appletl builds a proactive command OPEN 
CHANNEL calling ProactiveHandler . init { ) 
method 

6- send{) method is called to register to 
this event 



1 - Appletl is triggered by the 
envelope menu selection 



2- Appletl finalizes 

3- Appletl is not triggered 



4- Appletl is triggered by the 
envelope menu selection 



8- An envelope Event Download Data 
Available is sent to the UICC with Channel 
Status = 01 00 

9- An Envelope menu selection is sent to 
the UICC 

10- Appletl builds a proactive command 
OPEN CHANNEL calling 
ProactiveHandler . init { ) method 

11- send{) method is called to register to 
this event 



7- Appletl finalizes 

8- Appletl is not triggered 



9- Appletl is triggered by the 
envelope menu selection 



12- Appletl finalizes 



6- OPEN CHANNEL 
proactive command is 
fetched 

Unsuccessful TERMINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with General Result = 
0x10 



11- OPEN CHANNEL 
proactive command is 
fetched. 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with Channel Id = 01 
with General Result = 0x00 



Applet triggering to 

EVENT_EVENT_DOWNLOAD_DATA_AVAILAB 

LE 

1- An envelope Event Download Data 
Available is sent to the UICC 
Channel Status = 81 00 



1- Appletl is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


3 


Applet deregistration to EVENT EVENT 
DOWNLOAD_DATA_ AVAILABLE 








1- An Envelope menu selection is sent to 


1- Appletl is triggered 






the UICC 








2- Appletl initializes and sends an OPEN 




2- OPEN CHANNEL 




CHANNEL proactive command 




proactive command is 
fetched 

Successful terminal 
response is sent, with 
channelld=02 with General 
Result = 0x01 




3- Appletl builds a CLOSE CHANNEL 








Proactive Command calling 




3- CLOSE CHANNEL 




ProactiveHandler . initCloseChannel { ) and 




proactive command is 




ProactiveHandler . send { ) methods 




fetched 

Unsuccessful TERMINAL 
RESPONSE of CLOSE 
CHANNEL is sent to the 




4- An envelope Event Download Data 




UICC with General Result = 




Available is sent to the UICC 


4- Appletl is triggered 


0X20 




Channel Status = 82 








5- Appletl builds a CLOSE CHANNEL 




5- CLOSE CHANNEL 




Proactive Command calling 




proactive command is 




ProactiveHandler . initCloseChannel { ) and 




fetched 

Successful TERMINAL 




ProactiveHandler . send { ) methods. 










RESPONSE of CLOSE 








CHANNEL is sent to the 








UICC with Channel Id = 02 








with General Result = 0X02 






6- Appletl finalize 




4 


Applet triggering to 

EVENT EVENT DOWNLOAD DATA AVAILAB 

LE 








1- An envelope Event Download Data 


1 - Appletl is not triggered 






Available is sent to the UICC 








Channel Status = 82 






5 


Appletl not triggered after a reset 

1- Appletl is triggered by an envelope 
menu selection 

2- Appletl builds a proactive command OPEN 
CHANNEL calling ProactiveHandler . init { ) 
method 








3- sendO method is called to register to 




3- OPEN CHANNEL 




this event 




proactive command is 

fetched 

Successful TERMINAL 

RESPONSE of OPEN 

CHANNEL is sent to the 

UICC with Channel Id = 02 




4- isEventSetO method is called 


4- returns true 


with General Result = 0X00 




5- Reset the card 








6- An envelope Event Download Data 








Available is sent to the UICC 


6- Appletl is not triggered 






Channel Status = 82 
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5.5.3.20 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 

Test Area Reference: Cre_Apt_Edcs. 

5.5.3.20.1 Conformance requirement 

5.5.3.20.1.1 Normal execution 

• CRRN 1 ; For EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS, the framework shall only trigger the 
applet registered to this event with the appropriate channel identifier. 

• CRRN2: The registration to the EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS is effective once the 
toolkit applet has issued a successful OPEN CHANNEL proactive command, and valid till the first successful 
CLOSE CHANNEL or the end of the card session. 

• CRRN3: When a Toolkit Applet has sent an OPEN CHANNEL proactive command and received a successful 
TERMINAL RESPONSE, the framework shall register the received channel identifier for the calling Toolkit 
Applet. 

• CRRN4: When a Toolkit Applet has sent a CLOSE CHANNEL proactive command and received a successful 
TERMINAL RESPONSE, the framework shall release the channel identifier contained in the command. A 
successful TERMINAL RESPONSE means that the result of the proactive command execution belongs to 
command performed category (i.e. General Result ='0x'). 



5.5.3.20.1.2 
No requirements. 

5.5.3.20.1.3 
No requirements. 

5.5.3.20.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.20.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edcs.java. 
Cre_Apt_Edcs_l .Java. 
Cre_apt_edcs.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


2 


CRRN2 


1,4,5 


CRRN3 


1 


CRRN4 


3 



ETSI 



Release 6 



636 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.5.3.20.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD CHANNEL STAT 

US 

Appletl is registered to Event Menu 
Selection 








1- An Envelope menu selection is sent to 
the UICC 


1 - Appletl is triggered by the 
envelope menu selection 






2-The applet calls setEventO with 








EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS 


Appletl finalizes 






3- An envelope Event Download Channel 
Status is sent to the UICC 


3- Appletl is not triggered 






Channel Status = 81 00 








4- An Envelope menu selection is sent to 








the UICC 


4- Appletl is triggered by the 






5- Appletl builds a proactive command OPEN 


envelope menu selection 






CHANNEL calling ProactiveHandler . init { ) 








method 








6- send{) method is called to register to 




6- OPEN CHANNEL 




this event 


7- Applet finalizes 


proactive command is 

fetched 

Unsuccessful TERMINAL 

RESPONSE of OPEN 

CHANNEL is sent to the 

UICC with General Result = 

0x10 




8- An envelope Event Download Data 
Available is sent to the UICC with Channel 


8- Appletl is not triggered 






Status = 01 00 








9- An Envelope menu selection is sent to 


9- Appletl is triggered by the 






the UICC 


envelope menu selection 






10- Appletl builds a proactive command 








OPEN CHANNEL calling 








ProactiveHandler . init { ) method 




11- OPEN CHANNEL 




11- send{) method is called to register to 




proactive command is 




this event a second time 


12- Appletl finalizes 


fetched 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL is sent to the 
UICC with Channel Id = 01 
with General Result = 0x00 


2 


Applet triggering to 

EVENT EVENT DOWNLOAD CHANNEL 

STATUS 








1- An envelope Event Download Channel 
Status is sent to the UICC 


1- Appletl is triggered 






Channel Status = 81 00 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


3 


Applet deregistration to EVENT EVENT 
DOWNLOAD_CHANNEL STATUS 








1- An Envelope menu selection is sent to 


1- Appletl is triggered 






the UICC 








2-Appletl initializes and sends an OPEN 








CHANNEL proactive command 




2- OPEN CHANNEL 
proactive command is 
fetched 

Successful terminal 
response is sent, with 
channel ld=02 with General 
Result = 0x01 




3- Appletl builds a CLOSE CHANNEL 








Proactive Command calling 




3-CLOSE CHANNEL 




ProactiveHandler . initCloseChannel { ) and 




proactive command is 




ProactiveHandler . send { ) methods 




fetched 

Unsuccessful TERMINAL 
RESPONSE of CLOSE 
CHANNEL is sent to the 




4 -An envelope Event Download Channel 


4- The applet is triggered 


UICC with General Result = 




Status is sent to the UICC 




0X20 




Channel Status = 82 








5- Appletl builds a Close Channel 




5- CLOSE CHANNEL 




Proactive Command calling 




proactive command is 




ProactiveHandler . initCloseChannel { ) and 




fetched 




ProactiveHandler . send { ) methods 










Successful TERMINAL 








RESPONSE of CLOSE 








CHANNEL is sent to the 








UICC with Channel Id = 02 








with General Result = 0X02 






6- Appletl finalizes 




4 


Applet triggering to 

EVENT EVENT DOWNLOAD CHANNEL 

STATUS 








1- An envelope Event Download Channel 


1 - Appletl is not triggered 






Status is sent to the UICC 








Channel Status = 82 






5 


Appletl not triggered after a reset 

1- Appletl is triggered by an envelope 
menu selection 

2- Appletl builds a proactive command OPEN 
CHANNEL calling ProactiveHandler . init { ) 
method 








3- sendO method is called to register to 




3- OPEN CHANNEL 




this event 




proactive command is 

fetched 

Successful TERMINAL 

RESPONSE of OPEN 

CHANNEL is sent to the 

UICC with Channel Id = 02 

with General Result = 0X00 




4- isEventSetO method is called 


4- returns true 






5- Reset the card 








6- An envelope Event Download Channel 


6- Appletl is not triggered 






Status is sent to the UICC 








Channel Status = 82 
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5.5.3.21 EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE 

Test Area Reference: Cre_Apt_Edat. 

5.5.3.21.1 Conformance requirement 

5.5.3.21.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the 
EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE once it has registered to this event 
and an Envelope Event DownLoad Access Technology Change is received. 

• CRRN2: The applet is not triggered by the 
EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHANGE once it has deregistered from this 
event. 



5.5.3.21.1.2 
No requirements. 

5.5.3.21.1.3 
No requirements. 

5.5.3.21.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.21.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edat.j ava. 
Cre_Apt_Edat_ 1 .j ava. 
Cre_apt_edat.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.21.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD 

ACCESS_TECHNOLOGY_CHANGE and 

triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE and to EVENT_MENU_SELECTION 

Event = 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 

NGE 

1- ToolkitRegistry . isEventSet { ) method is 
called 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE is sent to the UICC 


1 - Method retums true 
2- Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event = 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 

NGE 

ToolkitRegistry . clearEvent { ) method is 

called 

1- An Envelope 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE is sent to the UICC 

2- An Envelope menu selection is sent to 
the UICC 

Event = 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 

NGE 

ToolkitRegistry . setEvent { ) method is 

called 

3- An Envelope 

EVENT_EVENT_DOWNLOAD_ACCESS_TECHNOLOGY_CHA 
NGE is sent to the UICC 


1 - Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 





5.5.3.22 EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED 

Test Area Reference: Cre_Apt_Eddp. 

5.5.3.22.1 Conformance requirement 

5.5.3.22.1.1 Normal execution 

• CRRNl: The applet is triggered by the 
EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED once it has registered to this 
event and an Envelope Event DownLoad Display Parameters Changed is received. 

• CRRN2: The applet is not triggered by the 
EVENT_EVENT_DOWNLOAD_DISPLAY_PARAMETERS_CHANGED once it has deregistered from this 
event. 



5.5.3.22.1.2 

No requirements. 

5.5.3.22.1.3 
No requirements. 

5.5.3.22.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.22.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Eddp.j ava. 
Cre_Apt_Eddp_l .Java. 
Cre_apt_eddp.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.22.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD 

DISPLAY_PARAMETERS_CHANGED and 

triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CH 
ANGED and to EVENT_MENU_SELECTION 

Event = 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CH 

ANGED 

1- ToolkitRegistry . isEventSet { ) method is 
called 

2- An Envelope 

EVENT EVENT DOWNLOAD DISPLAY PARAMETERS CH 
ANGED is sent to the UICC 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event = 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CH 

ANGED 

ToolkitRegistry. clearEvent { ) method is 

called 

1- An Envelope 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CH 
ANGED is sent to the UICC 

2- An Envelope menu selection is sent to 
the UICC 

Event = 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CH 

ANGED 

ToolkitRegistry . setEvent { ) method is 

called 

3- An Envelope 

EVENT_EVENT_DOWNLOAD_D I S PLAY_PARAMETERS_CH 
ANGED is sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 





5.5.3.23 EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

Test Area Reference: Cre_Apt_Edlc. 



5.5.3.23.1 



Conformance requirement 



5.5.3.23.1.1 



Normal execution 



CRRNl: For EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION, the framework shall only trigger 
the applet registered to this event with the associated service identifier. 

CRRN2: The registration to the EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION is effective once 
the toolkit applet has issued a successful DECLARE SERVICE (add) proactive command, and valid till the 
first successful DECLARE SERVICE (delete) with the corresponding service identifier or the end of the card 

session. 



5.5.3.23.1.2 

No requirements. 



Parameter errors 
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5.5.3.23.1.3 
No requirements. 

5.5.3.23.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.23.3 



Context errors 
Test area files 

Test_Cre_Apt_Edlc.j ava. 
Cre_Apt_Edlc_ 1 .j ava. 
Cre_apt_edlc.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


3,4,5 
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5.5.3.23.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Applet registration to 

EVENT_EVENT_DOWNLOAD 

LOCAL_CONNECTION 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 
using the allocateServiceldentif ier { ) 
method and to EVENT_MENU_SELECTION using 
the initMenuEntry { ) method. 

1- An envelope menu selection is sent to 
the UICC 

Event = 
EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION 

2- ToolkitRegistry . isEventSet { ) method is 
called 

3- An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION is 
sent to the UICC with the service 
identifier of Applet 

4- An envelope menu selection is sent to 
the UICC 

5- Applet builds and sends a DECLARE 
SERVICE (add) proactive command with its 
service ID to register to this event. 



6- An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAL_CONNECTION is 
sent to the UICC with the service 
identifier of Applet 

7- An envelope menu selection is sent to 
the UICC 

8- Applet builds and sends a DECLARE 
SERVICE (add) proactive command with its 
service ID to register to this event. 



1 - Applet is triggered 



2- Metliod returns true 

3- Applet is not triggered 



4- Applet is triggered by the 
envelope menu selection 

5- Applet finalizes 



6- Applet is not triggered 



7- Applet is triggered by the 
envelope menu selection 



9- Applet finalizes 



5- DECLARE SERVICE 

(add) proactive command is 

fetched 

Unsuccessful TERMINAL 

RESPONSE is sent to the 

UICC with General Result = 

0x20 



8- DECLARE SERVICE 

proactive command is 

fetched 

Successful TERIVIINAL 

RESPONSE is sent to the 

UICC with General Result = 

0x00 



Applet triggering to 

EVENT_EVENT_DOWNLOAD 

LOCAL_CONNECTION 

1- An envelope Event Download local 

connection is sent to the UICC 

with the service identifier of the Applet 



1 - Applet is triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


3 


Applet deregistration to 

EVENT EVENT DOWNLOAD 

LOCAL_CONNECTION with proactive 

command 

1- An Envelope menu selection is sent to 
the UICC 

2- Applet initializes and sends a DECLARE 
SERVICE (delete) proactive command with 
the service identifier of Applet 

3- An envelope Event Download local 
connection is sent to the UICC 

with the service identifier of the Applet 

4 -Applet initializes and sends a DECLARE 
SERVICE (delete) proactive command with 
the service identifier of Applet 


1- Appletl is triggered 

Applet finalizes 

3- Applet is triggered 

5- Applet finalizes 


2- DECLARE SERVICE 

(delete) proactive command 

is fetched 

Unsuccessful TERMINAL 

RESPONSE is sent to the 

UICC with General Result = 

0X20 

4- DECLARE SERVICE 

(delete) proactive command 

is fotchGcl 

Successful TERMINAL 

RESPONSE is sent to the 

UICC with General Result = 

0X00 


4 


Applet triggering to 

EVENT EVENT DOWNLOAD 

LOCAL_CONNECTION 

1- An envelope Event Download local 

connection is sent to the UICC 

with the service identifier of the Applet 


1- Applet is not triggered 




5 


Appletl not triggered after a reset 

1- Appletl is triggered by an envelope 
menu selection 

2- Applet builds and sends a DECLARE 
SERVICE (add) proactive command with its 
service ID to register to this event 

3- An envelope Event Download local 
connection is sent to the UICC 

with the service identifier of the Applet 

4- Reset the card 

5- An envelope Event Download local 
connection is sent to the UICC 

with the service identifier of the Applet 


3- Applet is triggered 
5- Applet is not triggered 


2- DECLARE SERVICE 

(add) proactive command is 

fetched 

Successful TERMINAL 

RESPONSE is sent to the 

UICC with General Result = 

0x00 



5.5.3.24 EVENT_APPLICATION_DESELECT 

Test Area Reference: Cre_Apt_Eade. 



5.5.3.24.1 



Conformance requirement 



5.5.3.24.1.1 



Normal execution 



CRRNl: The applet is triggered by the EVENT_APPLICATION_DESELECT once it has registered to this 
event and once an appHcation session is terminated (as described in TS 102 221 [5]). 
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• CRRN2: The applet is not triggered by the EVENT_APPLICATION_DESELECT once it has deregistered 
from this event. 

• CRRN3: The AID of the deselected application is available to the Toolkit Applet in the EnvelopeHandler, as 
an AID Comprehension TLV data object as defined in the TS 102 223 [6]. 



5.5.3.24.1.2 
No requirements. 

5.5.3.24.1.3 
No requirements. 

5.5.3.24.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.24.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Eade.j ava. 
Cre_Apt_Eade_ 1 .j ava. 
Cre_apt_eade.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 


CRRN3 


1,2 



5.5.3.24.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_APPLICATION_DESELECT and 

triggering 

Applet is registered to the 
EVENT_APPLICATION_DESELECT and to 
E VENT_iyiENU_S ELE CT I ON 

Event = 
EVENT_APPLICATION_DESELECT 








1- ToolkitRegistry . isEventSet { ) method is 
called 


1 - Method returns true 






2- Select for activation ADFl 


2- Applet is not triggered 






3- Select for activation ADF2 


3- Applet is triggered 

The envelope handler contains the 

AIDof ADF1 






4- Select for termination ADF2 


4- Applet is triggered 

The envelope handler contains the 

AIDof ADF2 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet deregistration 

Event = EVENT_APPLICATION_DESELECT 
ToolkitRegistry . clearEvent { ) method is 
called 

Perform UICC initialization 

1- Select for activation ADFl 








2- Select for activation ADF2 


2- Applet is not triggered 






3- Select for termination ADF2 


3- Applet is not triggered 






4- An Envelope menu selection is sent to 

the UICC 

Event = EVENT_APPLICATION_DESELECT 

ToolkitRegistry . setEvent { ) method is 

called 


4- Applet is triggered 






Perform UICC initialization 








5- Select for activation ADFl 


5- Applet is not triggered 






6- Select for activation ADF2 


6- Applet is triggered 

The envelope handler contains the 

AIDof ADF1 






7- Select for termination ADF2 


7- Applet is triggered 

The envelope handler contains the 

AIDof ADF2 





5.5.3.25 EVENT_PROACTIVE_HANDLER_AVAILABLE 

Test Area Reference: Cre_Apt_Epha. 

5.5.3.25.1 Conformance requirement 

5.5.3.25.1.1 Normal execution 

• CRRNl : The applet is triggered by the EVENT_PROACTIVE_HANDLER_AVAILABLE once it has 
registered to this event and once the ProactiveHandler is available and all the Toolkit Applets registered to the 
previous event have been triggered and have returned from the processToolkit() invocation. 

• CRRN2: The applet is not triggered by the EVENT_PROACTIVE_HANDLER_ AVAILABLE once it has 
deregistered from this event. 

• CRRN3: When the Toolkit Applet is triggered it is automatically deregistered by the CAT Runtime 
Environment. 

• CRRN4: If a CAT session ends prior to an Applet triggering, the Applet will be triggered at the next CAT 

session. 



5.5.3.25.1.2 
No requirements. 

5.5.3.25.1.3 
No requirements. 



Parameter errors 



Context errors 
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5.5.3.25.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.3.25.3 



Test area files 

Test_Cre_Apt_Epha.java. 
Cre_Apt_Epha_ 1 .j ava. 
Cre_Apt_Epha_2.j ava. 
Cre_apt_epha.cap. 

Test coverage 



CR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1 


CRRN3 


1 


CRRN4 


2 
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5.5.3.25.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_PROACTIVE_HANDLER_AVAILABLE, 

triggering and automatic deregistration 

Appletl is registered to 
EVENT_MENU_SELECTION 
Applet2 is registered to 
EVENT_MENU_SELECTION and 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








1- Appletl is triggered by an envelope 


1- Appletl is triggered 






menu selection 








1.1- ToolkitRegistry . setEvent { ) method is 


1.1- No exception is tlirown 






called with Event = 








EVENT_PROACTIVE_HANDLER_AVAILABLE 








1.2- ToolkitRegistry . setEvent { ) method is 
called with Event = 


1 .2- No exception is tlirown 






EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








1.3- ToolkitRegistry. isEventSet {) method 








is called with Event = 


1.3- IVIethod returns TRUE 






EVENT_PROACTIVE_HANDLER_AVAILABLE 


1.4- 

2- Appletl is triggered by 

EVENT PROACTIVE HANDLER 








AVAILABLE 


2- SW = 9000 is returned to 




Event= EVENT_PROACTIVE_HANDLER_AVAILABLE 




the envelope 




3- ToolkitRegistry . isEventSet { ) method is 


3- Method returns FALSE 






called by Appletl 








4- An envelope event download user 
activity is sent to the UICC 


4- Appletl is triggered by the 
envelope 






Event = EVENT_PROACTIVE_HANDLER_AVAILABLE 






5- ToolkitRegistry . setEvent { ) method is 


5- No exception is thrown 






called by Appletl 








6- ToolkitRegistry . isEventSet { ) method is 
called by Appletl 


6- IVIethod returns TRUE 
Appletl finalizes 
Applet2 is triggered by the 






Event = 


envelope 






EVENT_PROACTIVE_HANDLER_AVAILABLE 








7- ToolkitRegistry . setEvent { ) method is 


7- No exception is thrown 






called by Applet2 








8- ToolkitRegistry . isEventSet { ) method is 
called by Applet2 


8- Method returns TRUE 

Applet2 finalizes 

Appletl is triggered by 

EVENT PROACTIVE HANDLER 






Events 


AVAILABLE 






EVENT_PROACTIVE_HANDLER_AVAILABLE 








9- ToolkitRegistry . isEventSet { ) method is 








called by Appletl 


9- Method returns FALSE 

Appletl finalizes 

Applet2 is triggered by 

EVENT PROACTIVE HANDLER 

AVAILABLE 






Event = 








EVENT_PROACTIVE_HANDLER_AVAILABLE 








10- ToolkitRegistry . isEventSet { ) method is 
called by Appletl 


10- Method returns FALSE 
Applet2 finalizes 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Applet triggering between 2 CAT sessions 

1- Appletl is triggered by an envelope 
menu selection 

1.1- Appletl prepares and sends a Display 
Text proactive command 

2- Fetch the proactive command 

3- Applet2 is triggered by an envelope 
menu selection 

3.1 Applet2 registers to 

EVENT_PROACTIVE_HANDLER_AVAILABLE then 
finalizes 

4- Reset the card and send the profile 
download command 


1- Appletl is triggered 
1.1 Appletl is suspended 

3- Applet2 is triggered 
3.1- No exception is thrown 

4- Applet2 is triggered by event 
EVENT PROACTIVE HANDLER 
AVAILABLE 





5.5.3.26 EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE 

Test Area Reference: Cre_Apt_Edns. 

5.5.3.26.1 Conformance requirement 

5.5.3.26.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the 
EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE once it has registered to this 
event and an Envelope Event Event Download Network Search Mode Change is received. 

• CRRN2: The applet is not triggered by the 
EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_CHANGE once it has deregistered from 
this event. 



5.5.3.26.1.2 
No requirements. 

5.5.3.26.1.3 
No requirements. 

5.5.3.26.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.26.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Apt_Edns.java. 
Cre_Apt_Edns_l .Java. 
Cre_apt_edns.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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5.5.3.26.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT EVENT DOWNLOAD NETWORK SEA 

RCH_MODE_CHANGE and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 
HANGE and to EVENT_MENU_SELECTION 

event= 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 

HANGE 

1-ToolkitRegistry . isEventSet { ) method is 

called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 
HANGE is sent to the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

event= 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 

HANGE 

ToolkitRegistry . clearEvent { ) method is 

called 

1-A network search mode change event 
dowload is sent to the UICC 

2 -An Envelope menu selection is sent to 
the UICC 

Event = 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 

HANGE 

ToolkitRegistry . setEvent { ) method is 

called 

3 -An Envelope 

EVENT_EVENT_DOWNLOAD_NETWORK_SEARCH_MODE_C 
HANGE is sent to the UICC 


1- Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 





5.5.3.27 EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 

Test Area Reference: Cre_Apt_Edbs. 

5.5.3.27.1 Conformance requirement 

5.5.3.27.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLOAD_BROWSING_STATUS once it has 
registered to this event and an Envelope Event Event Download Browsing Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_BROWSING_STATUS once it 
has deregistered from this event. 



5.5.3.27.1.2 
No requirements. 

5.5.3.27.1.3 
No requirements. 



Parameter errors 



Context errors 
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5.5.3.27.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.27.3 



Test area files 

Test_Cre_Apt_Edbs.java. 
Cre_Apt_Edbs_l .Java. 
Cre_apt_edbs.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



5.5.3.27.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_BROWSING_STA 

TUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_BROWS ING_STATUS and 
to EVENT_MENU_SELECTION 

event= 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 
1-ToolkitRegistry . isEventSet { ) method is 
called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_BROWS ING_STATUS i s 
sent to the UICC 


1 - Method returns true 
2- Applet is triggered 




2 


Applet deregistration 

event= 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 
ToolkitRegistry . clearEvent { ) method is 
called 

1-A browsing status event dowload is sent 
to the UICC 

An Envelope menu selection is sent to the 
UICC 

Event = 

EVENT_EVENT_DOWNLOAD_BROWSING_STATUS 
ToolkitRegistry . setEvent { ) method is 
called 

2 -An Envelope 

EVENT_EVENT_DOWNLOAD_BROWS ING_STATUS i s 
sent to the UICC 


1 - Applet is not triggered 
2- Applet is triggered 
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5.5.3.28 EVENT_EXTERNAL_FILE_UPDATE 

Test Area Reference: Cre_Apt_Eefu 

5.5.3.28.1 Conformance requirement 

5.5.3.28.1.1 Normal execution 

• CRRN 1 : The applet is triggered by the EVENT_EXTERNAL_FILE_UPD ATE once it has registered to this 
event and a successful execution of an UPDATE BINARY or UPDATE RECORD or INCREASE APDU 
command (sent by the Terminal and received by the UICC on the I/O line) as defined in TS 102 221 [5] is 
performed on the associated updated file. 

• CRRN2: An applet shall only be triggered once per command. 

• CRRN3: The registration to this event is effective once the applet has successfully called a method 
registerFileEvent(. . .). 

• CRRN4: The applet is not triggered by the EVENT_EXTERNAL_FILE_UPDATE once it has deregistered 
from this event. 

• CRRN5: The deregistration for a particular file to this event is effective once the Applet has successfully 
called the method deregisterFileEvent(...). 

• CRRN6: A call to the method cZeflr£'venf(EVENT_EXTERNAL_FlLE_UPDATE) clears the event 
EVENT_EXTERNAL_FILE_UPDATE from the ToolkitRegistry of the Applet i.e. the Applet is no longer triggered 
when a file is updated. 



5.5.3.28.1.2 
No requirements. 

5.5.3.28.1.3 



Parameter errors 



Context errors 



• CRRCl : The applet shall not be triggered if the UPDATE BINARY or UPDATE RECORD or INCREASE 
APDU command are not sent by the Terminal and received by the UICC on the I/O line. 



5.5.3.28.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.3.28.3 



Test area files 

Test_Cre_Apt_Eefu.j ava. 
Cre_Apt_Eefu_ 1 .j ava. 
Cre_apt_eefu.cap. 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


1,2 


CRRN3 


1,2 


CRRN4 


2 


CRRN5 


2 


CRRN6 


3 


CRRC1 


See TS 131 213 [12] 



ETSI 



Release 6 



652 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.5.3.28.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EXTERNAL_FILE_UPDATE and 

triggering 

Applet is registerecJ to the 
EVENT_MENU_SELECTION 








1- SencJ an envelope menu selection 


1 - Applet is triggered 






Event = EVENT_EXTERNAL_FILE_UPDATE 








2-ToolkitRegistry . isEventSet { ) methocJ is 
calleca 


2- Method returns false 






3- ToolkitRegistry . registerFileEvent { ) 


3- No exception is thrown 






methocj with fileview is callecJ to register 








to EFtaru 


4- Method returns true 






4- ToolkitRegistry . isEventSet { ) methocJ is 








calleca 








5- ToolkitRegistry. registerFileEvent { ) 
methocJ with paths of EFlaeu anc3 EFcaeu is 


5- No exception is thrown 






callecJ 


Applet finalizes 






6- Update EFtaeu 

7- Update EFlaeu 

8- Increase EFcaeu 


6- Applet is triggered 

7- Applet is triggered 

8- Applet is triggered 




2 


Applet deregistration - case 1 








1 -Update EFtaeu 


1 - Applet is triggered 






2- ToolkitRegistry .deregisterFileEvent { ) 
method with fileview is called to 


2- No exception is thrown 






deregister EFcaeu 








Event = EVENT_EXTERNAL_F I LE^UPDATE 








3- ToolkitRegistry . isEventSet { ) method is 


3- Method returns true 






called 








4- Increase EFcaeu 


4- Applet is not triggered 






5- Update EFtaeu 


5- Applet is triggered 






6- ToolkitRegistry .deregisterFileEvent { ) 


6- No exception is thrown 






method with path of EFlaeu is called 








7- ToolkitRegistry . isEventSet { ) method is 
called 


7- Method returns true 






8- Update EFlaeu 


8- Applet is not triggered 






9- Update EFtaeu 


9- Applet is triggered 






10- ToolkitRegistry. deregisterFileEvent {) 
method with path of EFtaeu is called 


1 0- No exception is thrown 






11- ToolkitRegistry . isEventSet { ) method is 
called 


1 1 - Method returns false 






12- Update EFtaeu 


1 2- Applet is not triggered 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


3 


Applet deregistration - case 2 








1- Send an envelope menu selection 

2- ToolkitRegistry . registerFileEvent { ) 


1 - Applet is triggered 
2- No exception is thrown 






method with fileview is called to register 








to EFtaru 


3- No exception is thrown 






3- ToolkitRegistry. registerFileEvent { ) 








method with paths EFlaru and EFcaro is called 








4- Update EFtaru 

5- Update EFlaru 

6- Increase EFcaru 


4- Applet is triggered 

5- Applet is triggered 

6- Applet is triggered 






Event =EVENT_EXTERNAL_F I LE_UPDATE 


7- No exception is thrown 






7- ToolkitRegistry . clearEvent { ) method is 








called 








8- ToolkitRegistry . isEventSet { ) method is 


8- IVlethod returns false 






called 








9- Update EFtaru 

10- Update EFlaru 

11- Increase EFcaru 


9- Applet is not triggered 

1 0- Applet is not triggered 
1 1 - Applet is not triggered 






12- Restore EFcaru, EFtaru and EFlaru 







5.5.4 Proactive Command Sending by tine CAT Runtime Environment 



5.5.4.1 System Proactive Commands 

Test Area Reference: Cre_Pcs_Spco. 



5.5.4.1.1 



Conformance requirement 



5.5.4.1.1.1 



Normal execution 



CRRNl: During a CAT session the CAT Runtime Environment shall send a SET UP MENU system proactive 
command whenever a menu entry is modified, added or removed. 

CRRN2: The CAT Runtime Environment shall use the data of the EFsume file when issuing the SET UP 
MENU proactive command. 

CRRN3: During a CAT session the CAT Runtime Environment shall send a SET UP MENU system proactive 
command whenever the EFsume file under the DFxelecom file is updated as defined in TS 102 222 [7]. 

CRRN4: At the beginning of a CAT session, the CAT Runtime Environment shall send a SET UP MENU 
system proactive command, if at least one menu entry is registered and enabled by a selectable Toolkit Applet. 

CRRN5: At the beginning of a CAT session, the CAT Runtime Environment shall send a SET UP EVENT 
LIST system proactive command, if at least one event is registered by a selectable Toolkit Applet. 

CRRN6: During a CAT session the CAT Runtime Environment shall send a SET UP EVENT LIST system 
proactive command whenever the registered event list is changed. 

CRRN7: At the beginning of a CAT session, the CAT Runtime Environment shall send a POLL INTERVAL 
system proactive command, if at least one Toolkit Applet has requested a poll interval duration. 

CRRN8: During a CAT session the CAT Runtime Environment shall send a POLL INTERVAL or POLLING 
OFF system proactive command whenever the system poll interval duration is changed. 

CRRN9: The CAT Runtime Environment shall send its system proactive command(s) as soon as no proactive 
session is pending and all the applets registered to the current events have been triggered and have returned 
from the processToolkit method invocation. 
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CRRNIO: The system proactive command shall only contain information from Toolkit Applets that are in the 
selectable state. 

CRRNl 1 : If help is available for at least one Menu Entry inserted in the SET UP MENU system proactive 
command the CAT Runtime Environment shall indicate to the terminal that help information is available. 

CRRNl 2: If help is not available for all Menu Entries inserted in the SET UP MENU system proactive 
command the CAT Runtime Environment shall not indicate to the terminal that help information is available. 

CRRNl 3: If a text attribute different from the default format is provided for at least one Menu Entry, the SET 
UP MENU system proactive command shall contain the item text attribute list Comprehension TLV. The 
default format as defined in TS 123 040 [10] is '00 00 03 90'. 



5.5.4.1.1.2 

No requirements. 

5.5.4.1.1.3 

No requirements. 

5.5.4.1.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.4.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Pcs_Spco.java. 
Cre_Pcs_Spco_l .Java. 
Cre_Pcs_Spco_2.java. 
Cre_Pcs_Spco_3 .j ava. 
Cre_pcs_spco.cap. 

Test coverage 



CRR number 


Test case number 


CRRNl 


see: 
Api_2_Tkr_Cmet, CRRNl, 
Api 2 Tkr Dmet, CRRN3, 
Api 2 Tkr Emet, CRRN3, 
Api 2 Tkr Imet, CRRNl 
Api 2 Tkr Smta, CRRN3 


CRRN2 


1 


CRRN3 


1 


CRRN4 


2,3,4 


CRRN5 


5,6,7 


CRRN6 


8 


CRRN7 


9, 10, 11 


CRRN8 


12 


CRRN9 


13 


CRRNIO 


2,4, 6, 7, 10, 11 


CRRN11 


See Api 2 Tkr Cmet, CRRN6 


CRRN12 


See Api 2 Tkr Cmet, CRRN6 


CRRN13 


14 
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5.5.4.1.4 



Test procedure 



Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Set Up Menu at tlie beginning of a CAT session 

Install Applet2 

Applet2 registers to 

EVENT_UNRECOGNIZED_ENVELOPE and have its 
access conditions set to "ALWAYS" 

1- Perform UICC initialization with set up 
menu facilities supported 

2- Select EFsdme under DFtelecom with a select 
by path command 

3- Update EFsdme with the text "TEST MENU" 
and Text Attribute "00 00 13 90" (Bold) 



4- An unrecognized envelope is sent to 
trigger Applet2 



5- An unrecognized envelope is sent to 
trigger Applet2 



6- The EFsdme under DFtelecom is updated with 
the text "UICC TEST" and restore the 
initial Text Attribute 



4- Applet2 selects EFsume and 
updates its content with the text 
"TEST UICC" and no Text Attribute 

5- Applet2 selects EFsume and 
updates its content with the text 
"TEST UICC" and Text Attribute "00 
00 13 90" 



1- SET UP IVIENU with main 
menu "UICC TEST" 

2- SW = 9000 

3- SET UP IVIENU with main 
menu "TEST MENU" and 
Text Attribute "00001390" 

4- SET UP IVIENU with main 
menu "TEST UICC" and no 
Text Attribute 

5- SET UP MENU with main 
menu "TEST UICC" and 
Text Attribute "00001390" 



6- SET UP MENU with main 
menu "UICC TEST" 



Set Up Menu at tlie beginning of a CAT session 

1- Install Appletl 

Appletl registers to EVENT_MENU_SELECTION 
using the initMenuEntry { ) , to 
EVENT_STATUS_COMMAND using the 
requestPollIntervall { ) and to 
EVENT_EVENT_DOWNLOAD_MT_CALL , 
EVENT EVENT DOWNLOAD LOCATION STATUS 



1- SET UP MENU with the 
menu of Appletl 



Set Up Menu with applet In LOCK state 



1- Lock Appletl 



1- SET UP MENU With no 
menu of Appletl 



Set Up Menu with applet In SELECTABLE state 

1- Make selectable Appletl 



2- An envelope menu selection is sent to 
trigger Appletl 

3- Appletl disables its menu 

4- An envelope event download MT call is 
sent to trigger Appletl 

5- Appletl enables its menu 



2- Appletl is triggered 



4- Appletl is triggered 



1- SET UP MENU with the 
menu 



3- SET UP MENU with no 
menu 



5- SET UP MENU with the 
menu 



Set Up Event List at the beginning of a CAT 
session 

1- Perform UICC initialization with EVENT 
DOWNLOAD and set up event list facilities 
supported 



1- SET UP EVENT LIST 
proactive command 
[Event list]= '19020003' or 
'99020003' 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Setup Event List with applet in LOCK state 




1- SET UP EVENT LIST 




1- Lock Appletl 




Proactive command 
[CommandQualifier]= OOh 


7 


Setup Event List with applet in SELECTABLE 
state 








1- Make selectable Appletl 




1- SET UP EVENT LIST 
proactive command 
[Event list]= '19020003' or 
'99020003' 


8 


Dynamic setup event list on registry 
modification 








1- An envelope menu selection is sent to 
trigger Appletl 


1- Appletl is triggered 






2- Appletl deregisters to event 
EVENT_EVENT_DOWNLOAD_MT_CALL 




2- SET UP EVENT LIST 
proactive command 
[Event list]= '190103' or 
'990103' 




3- An unrecognized envelope is sent to 








trigger Applet2 


3- Applet2 is triggered 






4- Applet registers to event 
EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
to EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 




4- SET UP EVENT LIST 
proactive command 
[Event list]= '19020307' or 




5- An envelope event download location 


5- Appletl and Applet2 are 


'99020307' 




status is sent to the UICC 


triggered 


6- SET UP EVENT LIST 




6- Appletl and Applet2 clear their events 




proactive command 




download 




[CommandQualifier]= OOh 




7- An envelope menu selection is sent to 


7- Appletl is triggered 






trigger Appletl 




8- SET UP EVENT LIST 




8- Appletl registers to event 




proactive command 




EVENT_EVENT_DOWNLOAD_MT_CALL 




[Event list]= '190100' or 
'990100' 




9- Delete Appletl 




9- SET UP EVENT LIST 
proactive command 
[CommandQualifier]= OOh 




10- Install Appletl {same registration as 




10- SET UP EVENT LIST 




before, plus registration to 
EVENT_UNRECOGNIZED_ENVELOPE) 




proactive command 
[Event list]= '19020003' or 
'99020003' 


9 


Poll Interval at the beginning of a CAT session 








1- Perform UICC initialization with 
polling facilities supported 




1- POLL INTERVAL 
proactive command 


10 


Poll Interval with applet in LOCK state 








1- Lock Appletl 




1- POLLING OFF proactive 
command 


11 


Poll Interval with applet in SELECTABLE state 








1- Make selectable Appletl 




1- POLL INTERVAL 
proactive command 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



12 



Dynamic Polling commands on registry 
modification 

1- A status command is sent 

2- Appletl calls the method 
requestPollInterval { ) with 
POLL_NO_DURATION 

3- An unrecognized envelope is sent 

4- Appletl calls the method 
requestPollInterval { ) with 
POLL_SYSTEiyi_DURATION 

5- Delete Appletl 



6- Install Appletl {same registration as 
before, plus registration to 
EVENT UNRECOGNIZED ENVELOPE) 



1- Appletl is triggered 



3- Appletl is triggered 

Appletl finalizes 
Applet2 is triggered 



2- POLLING OFF proactive 
command 



4- POLL INTERVAL 
proactive command 

5- POLLING OFF proactive 
command 

6- POLL INTERVAL 
proactive command 



13 



System Proactive Commands sending 

1- Perform UICC initialization with system 
proactive commands facilities 

2- An unrecognized envelope is sent 

3- Appletl deregisters to event 
EVENT_EVENT_DOWNLOAD_MT_CALL and 
UNRECOGNIZED_ENVELOPE, disables its menu 
entry, calls method requestPollIntervall { ) 
with POLL_NO_DURATION then builds and 
sends a Display Text Proactive command 
with text 'Textl' 



4- Applet2 registers to event 
EVENT_PROACTIVE_HANDLER_AVAILABLE , disable 
its menu entry then builds and sends a 
Display Text Proactive command with text 
'Text21' 



5- Applet2 builds and sends a Display Text 
Proactive command with text 'Text22' 



2- Appletl is triggered 



Appletl finalizes 
Applet2 is triggered 



Applet2 finalizes 

Applet2 is triggered by event 

EVENT_PROACTIVE_HANDLER_ 

AVAILABLE 



Applet2 finalizes 



3- Display Text with text 
'textl ' proactive command 



4- Display Text with text 
'text21' proactive command 



7- Delete Appletl 



5- Display Text with text 
'text22' proactive command 



6- SET UP MENU proactive 
command with no menu, 
SET UP EVENT LIST 
proactive command 
[Event list]= '190103' or 
'9901 03' and 
POLLING OFF proactive 
command 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


14 


Text Attribute management in Set Up Menu 








1- Install Applets, Applets calls the 




1- SET UP MENU proactive 




initMenuEntry { ) method, then reinitialize 
the card. 




command with one menu 






and no Item Text Attribute 








List or the default Text 








Attribute List '00000S90" 




2- Send an Unrecognized Envelope to 


2- Applet2 is triggered 






trigger Applet2 








3- Applet2 enable its menu entry 


Applet2 finalizes 


3- SET UP MENU proactive 
command two menus and 
no Item Text Attribute List or 
the default Text Attribute 
List '00000S9000000S90" 




4-Send an envelope Menu Selection with the 








Item Id of Applet2 


4- Applet2 is triggered 






5- Applet2 calls 








setMenuEntryTextAttribute { ) method to set 








the attribute to "00 00 13 90" (Bold) 


Applet2 finalizes 


5- SET UP MENU proactive 
command two menus and 
the Item Text Attribute List 
"00001390 00000S90" 




6-Send an envelope Menu Selection with the 
Item Id of Applet2 


6- Applet2 is triggered 


7- SET UP MENU proactive 




7- Applet2 calls disableMenuEntry { ) 


Applet2 finalizes 

8- Applets is triggered 


command with one menu 
and no Item Text Attribute 
List or the default Text 
Attribute List '00000S90" 




8-Send an envelope Menu Selection with the 








Item Id of Applet3 








9- Applet3 calls 


Applets finalizes 


9- SET UP MENU proactive 




SetMenuEntryTextAttribute { ) method to set 




command one menu and 




the attribute to "00 00 23 90" (Italic) 


10- Applet2 is triggered 


the Item Text Attribute List 
"00002390" 




10-Send an envelope Menu Selection with 








the Item Id of Applet2 








11- Applet2 calls enableMenuEntry { ) 


Applet2 finalizes 


11- SET UP MENU 
proactive command two 
menus and the Item Text 
Attribute List "00001 390 
00002S90" 




12-Send an envelope Menu Selection with 
the Item Id of Applet2 


1 2- Applet2 is triggered 


13- SET UP MENU 




13- Applet2 calls 




proactive command two 




SetMenuEntryTextAttribute { ) method to set 


Applet2 finalizes 


menus and the Item Text 




the attribute to "00 00 03 90" (default) 




Attribute List "00000390 
00002S90" 

14- SET UP MENU 




14- Lock Applet3 




proactive command with 
one menu and no Item Text 
Attribute List or the default 
Text Attribute List 
'00000390" 

15- SET UP MENU 




15- unlock Applets 


1 6- Applets is triggered 


proactive command two 
menus and the Item Text 
Attribute List "00000390 
00002S90" 




16- Send an envelope Menu Selection with 








the Item Id of Applet3 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 




17- Applets calls 

setMenuEntryTextAttribute { ) method to set 
the attribute to "00 00 03 90" (default) 


Applets finalizes 


17- SET UP MENU 
proactive command two 
menus and no Item Text 
Attribute List or the default 
Text Attribute List 
'0000039000000390" 



5.5.4.2 Interaction with GSM commands 

Test Area Reference: Cre_Pcs_Igco 



5.5.4.2.1 



5.5.4.2.1.1 



Conformance requirement 



Normal execution 



CRRNl: The CAT Runtime Environment shall process a UICC command even when a proactive command is 
pending (before and after the FETCH command until the terminal response). The CAT Runtime Environment 
shall answer with the SWl and SW2 described in TS 102 221 [5] and TS 102 223 [6]. 



5.5.4.2.1.2 

No requirements. 

5.5.4.2.1.3 

No requirements. 

5.5.4.2.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.4.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Pcs_Igco.j ava. 
Cre_Pcs_Igco_l .Java. 
Cre_pcs_igco.cap. 

Test coverage 



GRR number 


Test case number 


CRRNl 


1,2,3 
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5.5.4.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Interaction with GSM Commands after 

TERMINAL PROFILE in connection with FETCH 

and TERMINAL RESPONSE 

Applet is registered to Menu Selection 

RST 

TERMINAL PROFILE 

{Profile: supports all facilities except: 
SET UP EVENT LIST, POLL INTERVAL and 
POLLING OFF) 

1- System issues a proactive command 
SETUP_MENU 

2- SELECT MF 

3- Failed SELECT File 

4- FETCH 

5- SELECT MF 

6- TERMINAL RESPONSE 




1-91XX 

2- Expected data = XX XX 
XX XX 3F 00 

SW = 91XX 

3- 6A82 

4- Proactive Command: 
SETUP MENU 

5- Expected data = XX XX 
XX XX 3F 00 

SW = 9000 

6- 9000 


2 


Interaction with GSM Commands after 

ENVELOPE (MENU SELECTION) 

in connection with FETCH and TERMINAL 

RESPONSE 

Menu Entry ID = 0x01 

1- SELECT MF 

2- Failed SELECT File 

3- FETCH 

4- SELECT MF 

5- TERMINAL RESPONSE 




1 - Expected data = XX XX 
XX XX 3F 00 
SW = 91XX 

2- 6A82 

3- Proactive Command: 
Display Text 

4- Expected data = XX XX 
XX XX 3F 00 

SW = 9000 

5- 9000 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


3 


Interaction with GSM Commands after 
TERMINAL RESPONSE in proactive command 
session in connection with FETCH and 
TERMINAL RESPONSE 

Menu Entry ID = 0x02 








1- SELECT MF 




1 - Expected data = XX XX 
XX XX 3F 00 
SW = 91XX 




2- FETCH 




2- Proactive Command: 




3- SELECT MF 




Display Text 

3- Expected data = XX XX 

XX XX 3F 00 




4- Failed SELECT File 

5- TERMINAL RESPONSE 




SW= 9000 
4- 6A82 
5- 91 XX 




6- SELECT MF 








7-Failed SELECT File 
8 -FETCH 




6- Expected data = XX XX 

XX XX 3F 00 

SW = 91XX 

7-6A82 

8-Proactive Command: 




9 -SELECT MF 




Display Text 




10-TERMINAL RESPONSE 




9- Expected data = XX XX 
XX XX 3F 00 
SW = 9000 
10-9000 



5.5.4.3 Proactive Command Control 

Test Area Reference: Cre_Pcs_Pcco. 



5.5.4.3.1 



Conformance requirement 



5.5.4.3.1.1 



Normal execution 



CRRNl: The CAT Runtime Environment shall prevent the toolkit applet to issue the following proactive 
commands: SET UP MENU, SET UP EVENT LIST, POLL INTERVAL, POLLING OFF. If an applet 
attempts to issue such a command, the CAT Runtime Environment shall throw an exception. 

CRRN2: The CAT Runtime Environment shall prevent a toolkit applet to issue a TIMER MANAGEMENT 
proactive command using a timer identifier, which is not allocated to it. If an applet attempts to issue such a 
command, the CAT Runtime Environment shall throw an exception. 

CRRN3: The CAT Runtime Environment shall prevent a toolkit applet to issue a SEND DATA, RECEIVE 
DATA and CLOSE CHANNEL proactive commands using a channel identifier, which is not allocated to it. If 
an applet attempts to issue such a command the CAT Runtime Environment shall throw an exception. 

CRRN4: The CAT Runtime Environment shall prevent a toolkit applet to issue an OPEN CHANNEL 
proactive command if it exceeds the maximum number of channel allocated to this applet. If an applet attempts 
to issue such a command the CAT Runtime Environment shall throw an exception. 

CRRN5: The CAT Runtime Environment shall prevent a Toolkit Applet to issue a DECLARE SERVICE (add, 
delete) proactive command using a service identifier, which is not allocated to it. If an applet attempts to send 
such a command, the CAT Runtime Environment shall throw an exception. 

CRRN6: All proactive commands shall be sent to the terminal as constructed by the Toolkit Applet without 
any check by the CAT Runtime Environment. 

CRRN7: The CAT Runtime Environment cannot guarantee that if the SET UP IDLE MODE TEXT proactive 
command is used by a Toolkit Applet, another Toolkit Applet will not overwrite this text at a later stage. 
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5.5.4.3.1.2 

No requirements. 

5.5.4.3.1.3 

No requirements. 

5.5.4.3.2 

Test Source: 
Test Applet : 



Cap File: 
5.5.4.3.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Pcs_Pcco.java. 
Cre_Pcs_Pcco_l .Java. 
Cre_Pcs_Pcco_2.j ava. 
Cre_Pcs_Pcco_3 .j ava. 
Cre_pcs_pcco .cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


3,4 


CRRN4 


3,4 


CRRN5 


5 


CRRN6 


6 


CRRN7 


Not testable 



5.5.4.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





Applets installation 

Appletl is installecJ with 4 timers 
maximum, channel maximum, 1 menu and 4 
service icJentifiers maximum 
Applet2 is installecJ with 8 timers 
maximum, 3 channels maximum, 1 menu and 8 
service identifiers maximum 
Applets is installed with 1 channel 
maximum, 1 menu and no service identifier 






1 


STK Proactive Commands 

1- Send envelope menu selection with the 
item id of Appletl 

2- Appletl builds and sends a SET UP MENU 
proactive command 

3- Appletl builds and sends a SET UP EVENT 
LIST proactive command 

4- Appletl builds and sends a POLL 
INTERVAL proactive command 

5- Appletl builds and sends a POLLING OFF 
proactive command 


1- Appletl is triggered 

2- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

3- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

4- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

5- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 


1 - 90 00 (no proactive 
command is sent) 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


TIMER MANAGEMENT Proactive command 

1- Send envelope menu selection with the 
item id of Applet2 

2- Applet2 allocates 8 timers by calling 
allocateTimer { ) method and release the 3 
timers from id 1 to 3 . 

3- Send envelope menu selection with the 
item id of Appletl 

4- Appletl allocates 3 timers {Id 1 to 3) 
by calling allocateTimer { ) method 3 times 

5- Send envelope menu selection with the 
item id of Applet2 

6- Applet2 releases timers of Id 4 to 7 

7- Send envelope menu selection with the 
item id of Appletl 

8- For each of the 3 timers allocated by 
Appletl {Id Ito 3) a TIMER MANAGEMENT 
proactive session is performed 

9- For other timers {Id 4 to 8) , Appletl 
builds and sends a TIMER MANAGEMENT 
proactive command 


1- Applet2 is triggered 

2- No exception is thrown 

3- Appletl is triggered 

4- No exception is thrown 

5- Applet2 is triggered 

6- No exception is thrown 

7- Appletl is triggered 

8- No exception is thrown 

9- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 


8- 3 TIMER MANAGEMENT 
proactive commands are 
fetched 

9- The Status word of the 
last previous Terminal 
Response is 90 00 (no more 
proactive command is sent) 


3 


No Channel allowed 

1 Send envelope menu selection with the 
item id of Appletl 

2- Appletl builds and sends a CSD OPEN 
CHANNEL proactive command 

3- Appletl builds and sends a GPRS OPEN 
CHANNEL proactive command 

4- Appletl builds and sends a SEND DATA 
proactive command 

5- Appletl builds and sends a RECEIVE DATA 
proactive command 

6- Appletl builds and sends a CLOSE 
CHANNEL proactive command 


1- Appletl is triggered 

2- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

3- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

4- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

5- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 

6- COMMAND_NOT_ALLOWED 
ToolkitException is thrown 


1 - 90 00 (no proactive 
command is sent) 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


4 


4 Channels allowed 








1- Send envelope menu selection with the 


1- Applets is triggered 






item id of Applets 








2- Applets builds and sends a CSD OPEN 








CHANNEL proactive command 


2- No exception is thrown 


2-91 1C 




3- Send a Fetch and Terminal Response OK 








on channel 7 




3- OPEN CHANNEL 
proactive 




4- Send envelope menu selection with the 








item id of Applet2 

5- Applet2 builds and sends a CSD OPEN 


4- Applet2 is triggered 






CHANNEL proactive command 








6- Send a Fetch and Terminal Response OK 


5- No exception is thrown 


5-91 1C 




on channel 1 




6- OPEN CHANNEL 




7- Applet2 builds and sends a GPRS OPEN 




proactive command is 




CHANNEL proactive command 




fetched 




8- Send Fetch and Terminal Response OK on 
channel 2 


7- No exception is thrown 


7-91 17 

8- OPEN CHANNEL 




9- For each channel id from 3 to 7, 


9- COIVIIVIAND_NOT_ALLOWED 


proactive command is 




Applet2 builds and sends a SEND DATA 


ToolkitException is thrown 


fetched, SW = 91 1 Con the 




proactive command 


10- COMMAND_NOT_ALLOWED 


Terminal Response 




10- For each channel id from 3 to 7, 


ToolkitException is thrown 






Applet2 builds and sends a RECEIVE DATA 


1 1 - COMMAND_NOT_ALLOWED 






proactive command 

11- For each channel id from 3 to 7, 


ToolkitException is thrown 






Applet2 builds and sends a CLOSE CHANNEL 








proactive command 


1 2- No exception is thrown 






12- Applet2 builds and sends a CSD OPEN 








CHANNEL proactive command 




13- OPEN CHANNEL 




13- Fetch and Terminal Response OK on 




proactive command is 




channel 3 




fetched 




14- Applet2 builds and sends an OPEN 


14- COMMAND_NOT_ALLOWED 


1 4- 90 00 expected to the 




CHANNEL proactive command 


ToolkitException is thrown 


previous Terminal 
Response (no proactive 
command is sent) 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


5 


DECLARE SERVICE Proactive command 








1- Send envelope menu selection with the 


1- Applet2 is triggered 






item id of Applet2 








2- Applet2 allocates 8 services by calling 








allocateServiceldentif ier { ) method and 


2- No exception is thrown 






release the 3 services from id to 2 








using method releaseServiceldentif ier { ) . 








3- Send envelope menu selection with the 


3- Appletl is triggered 






item id of Appletl 


4- No exception is thrown 






4- Appletl allocates 3 services {Id to 






2) by calling allocateServiceldentif ier { ) 








method 3 times 


5- Applet2 is triggered 






5- Send envelope menu selection with the 








item id of Applet2 


6- No exception is thrown 






6- Applet2 releases services of Id 5 to 7 


7- Appletl is triggered 






7- Send envelope menu selection with the 








item id of Appletl 


8- No exception is thrown 


8- 3 DECLARE SERVICE 




8- For each of the 3 services allocated by 








Appletl {Id to 2) DECLARE SERVICE {add) 




proactive commands are 




proactive commands are sent 




fetched 




9- For other services (Id 3 to 8), Appletl 


9- COMMAND_NOT_ALLOWED 






builds and sends a DECLARE SERVICE {add) 


ToolkitException is thrown 


9- The Status word of the 




proactive command 




last previous Terminal 
Response is 91 1 C on the 
Terminal Response 




10- For each of the 3 services allocated 


1 0- No exception is thrown 


10- 3 DECLARE SERVICE 




by Appletl {Id to 2) DECLARE SERVICE 




proactive commands are 




{delete) proactive commands are sent 




fetched 




11- For other services {Id 3 to 8) , 


1 1 - COMMAND_NOT_ALLOWED 


1 1 - The Status word of the 




Appletl builds and sends a DECLARE SERVICE 


ToolkitException is thrown 


last previous Terminal 




{delete) proactive command 




Response is 90 00 (no more 
proactive command is sent) 


6 


Unknown proactive command 








1- Send an envelope menu selection with 


1- Appletl is triggered 






the item id of Appletl 








2- Appletl builds an unknown proactive 
command 




2- 91 08 




3- Fetch and terminal response OK 




3- The unknown proactive 
command is fetched 



5.5.5 Exception Handling 
5.5.5.1 General Behaviour 

Test Area Reference: Cre Exh Genb. 



5.5.5.1.1 



Conformance requirement 



5.5.5.1.1.1 



Normal execution 



• CRRNl: If more than one Applet shall be triggered by the currently processed event all Exceptions shall be 
caught by the CAT Runtime Environment and shall not be sent to the terminal. The CAT Runtime 
Environment shall proceed with the triggering. 

• CRRN2: If only one Applet shall be triggered by the currently processed event and an ISOException with the 
reason code REPLY_BUSY is thrown, it shall be sent to the terminal using the Status Word 0x9300. 

• CRRN3: If only one Applet shall be triggered by the currently processed event other Exceptions than an 
ISOException with the reason code REPLY_BUSY shall not be propagated to the terminal. 



ETSI 



Release 6 



666 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.5.5.1.1.2 

No requirements. 

5.5.5.1.1.3 

No requirements. 

5.5.5.1.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.5.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Exh_Genb .j ava. 
Cre_Exh_Genb_l .Java. 
Cre_Exh_Genb_2.j ava. 
Cre_exh_genb . cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


3 



5.5.5.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





Appletl is installed and registers to 
EVENT_MENU_SELECTION and 
EVENT_EVENT_DOWNLOAD_MT_CALL 

Applet2 is installed and registers to 
EVENT_EVENT_DOWNLOAD_MT_CALL and 
EVENT EVENT DOWNLOAD USER ACTIVITY 






1 


ISOException REPLY_BUSY is not sent to the 
terminal in multi triggering 

1- Send an envelope Event Download MT Call 
{multi triggering event, multi registered 
applets) 

4- Send an envelope Event Download MT Call 
(multi triggering event, multi registered 
applets) 


1- Appletl is triggered 

2- Appletl sends a ISOException 
with the reason code 
REPLY_BUSY then finalizes 

Applet2 is triggered, does nothing 
and finalizes 

4- Appletl is triggered, does 
nothing and finalizes 

Applet2 is triggered, sends a 
ISOException with the reason code 
REPLY_BUSY then finalizes 


3- SW = 90 00 
5- SW = 90 00 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


ISOException REPLY_BUSY is sent to the 
terminal in single triggering 

1- Send an envelope Menu Selection to 
trigger Appletl {single triggering event) 

2- Send an envelope Event Download User 
Activity {multi triggering event, single 
registered applet) 


1 - Appletl is triggered, sends a 
ISOException with the reason code 
REPLY_BUSY then finalizes 

2- Applet2 is triggered, sends a 
ISOException with the reason code 
REPLY BUSY then finalizes 


1 - SW = 93 00 
2- SW = 93 00 


3 


Other exception than ISOException 
REPLY_BUSY are not sent to the terminal 

1- Send an envelope Menu Selection to 
trigger Appletl {single triggering event) 

2- Send an envelope Menu Selection to 
trigger Appletl {single triggering event) 


1 - Appletl is triggered, sends a 
ISOException with reason code 
different to REPLY_BUSY then 
finalizes 

2- Appletl is triggered, sends a 
ToolkitException then finalizes 


1-SW = 90 00 
2- SW = 90 00 



5.5.5.2 Interaction with Multiple Triggering 

Test Area Reference: Cre_Exh_Imtg. 



5.5.5.2.1 



5.5.5.2.1.1 



Conformance requirement 



Normal execution 



• CRRNl: An exception thrown by a toolkit applet, will not influence toolkit applets registered to the same 
event. 



5.5.5.2.1.2 

No requirements. 

5.5.5.2.1.3 

No requirements. 

5.5.5.2.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.5.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Exh_Imtg.j ava. 
Cre_Exh_Imtg_l .Java. 
Cre_Exh_Imtg_2.j ava. 
Cre_exh_imtg.cap. 

Test coverage 



GRR Number 


Test Case Number 


CRRNl 


1,2,3,4 
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5.5.5.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





Load/install 2 tooll<it applets registered to 

EVENT STATUS COMMAND, 

EVENT PROFILE DOWNLOAD, 

EVENT UNRECOGNIZED ENVELOPE, 

EVENT_EVENT_DOWNLOAD_MT_CALL 

Appletl: Priority= 0x01, 
Applet2 : Priority= 0x02, 
{i.e. Appletl is triggered before Applet2) 






1 


Profile_Download is sent 


1- Appletl is triggered 

2- NullPointerException is tlirown 

3- Applet2 is triggered 




2 


status Command is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




3 


UNRECOGNIZED_Envelope is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




4 


Event_Download_MT_Call is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 





5.5.6 Envelope Response Posting 
5.5.6.1 General Behaviour 

Test Area Reference: Cre_Erp_Genb. 

5.5.6.1.1 Conformance requirement 



5.5.6.1.1.1 



Normal execution 



CRRNl: A Toolkit Applet can post a response to some events with the post() or the postAsBERTLV() methods 
and can continue its processing after the call to these methods. 

CRRN2: The CAT Runtime Environment shall send the response before the emission of the next proactive 
command or when all the Toolkit Applets triggered by the event have finished their processing. 

CRRN3: The Boolean parameter passed to the post() or postAsBERTLV() method shall be mapped by the CAT 
Runtime Environment to the correct status word. If the value is true it corresponds to a successful ending of 
the command status word "9000". If the value is false it corresponds to a warning status word "6200". 



5.5.6.1.1.2 

No requirements. 



Parameter errors 
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5.5.6.1.1.3 

No requirements. 

5.5.6.1.2 
None. 

5.5.6.1.3 



Context errors 



Test area files 



Test coverage 



CRR Number 


Test Case Number 


CRRN1 


SeeApi 2 Erh Postb: CRRN1 
SeeApi 2 Erh Postbb: CRRN1 


CRRN2 


SeeApi 2 Erh Postb: CRRN3 
SeeApi 2 Erh Postbb: CRRN3 


CRRN3 


SeeApi 2 Erh Postb: CRRN4 
SeeApi 2 Erh Postbb: CRRN4 



5.5.6.1.4 
None. 



Test procedure 



5.5.6.2 EVENT_CALL_CONTROL_BY_NAA 

Test Area Reference: Cre_Erp_Eccn. 

5.5.6.2.1 Conformance requirement 

5.5.6.2.1.1 Normal execution 

• CRRNl: The CAT Runtime Environment can't reply busy when an Envelope(Call Control) is sent to the 
UICC. 



5.5.6.2.1.2 

No requirements. 

5.5.6.2.1.3 

No requirements. 

5.5.6.2.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.6.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Erp_Eccn.j ava. 
Cre_Erp_Eccn_l .Java. 
Cre_Erp_Eccn_2.j ava. 
Cre_Erp_Eccn_3 .j ava. 
Cre_erp_eccn. cap . 

Test coverage 



CRR Number 


Test Case Number 


CRRNl 


1,2 
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5.5.6.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Appletl is registered on the 

EVENT_CALL_CONTROL_BY_NAA, Applet2 is 

registered and triggered on the 

EVENT_MENU_SELECTION. 

1- Applet2 invokes the method send{) and 
no fetch is performed 

2- Envelope {Call Control) is sent to the 
UICC 

3- Appletl calls the method 
EnvelopeResponseHandler .postASBERTLV{ ) to 
change any incoming dialling number into 
+11 22 33 44 

4- A Fetch command is sent to the UICC 

5- A Terminal Response command is sent to 
the UICC 

6- Delete Appletl & Applet2 

7- Install Applet3 


1 - Applet2 is suspended 
2- Appletl is triggered 

5- Applet2's execution stiall 
continue 


S- The dialling number is 
retrieved and the status 
words is 91 XX 


2 


Applets is registered on both the events 

EVENT CALL CONTROL BY NAA and 

EVENT_MENU_SELECTION 

1- Envelope Menu Selection is sent to the 
UICC 

2- Applets invokes the method send {) and no 
fetch is performed 

3- Envelope {Call Control) is sent to the 
UICC 

4- Applets calls the method 
EnvelopeResponseHandler .postASBERTLV{) to 
change any incoming dialling number into 
+11 22 33 44 

5- A Fetch command is sent to the UICC 

6- A Terminal Response command is sent to 
the UICC 


1 - Applets is triggered on the 
EVENT_MENU_SELECTION 

2- Applets is suspended on the 
sendQ method 

5- Applets is triggered on the 
EVENT CALL CONTROL BY NA 
A 

6- The AppletS's execution shall 
continue 


4- The dialling number is 
retrieved and the status 
words is 91 XX 



5.5.6.3 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: Cre_Erp_Euen. 

5.5.6.3.1 Conformance requirement 

5.5.6.3.1.1 Normal execution 

• CRRN 1 : The EnvelopeResponseHandler is available for the EVENT_UNRECOGNIZED_ENVELOPE. 

5.5.6.3.1 .2 Parameter errors 
No requirements. 
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5.5.6.3.1.3 

No requirements. 

5.5.6.3.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.6.3.3 



5.5.6.3.4 



Context errors 
Test area files 

Test_Cre_Erp_Euen.j ava. 
Cre_Erp_Euen_ 1 .j ava. 
Cre_erp_euen . c ap . 

Test coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


An applet triggered on the 

EVENT_UNRECOGNIZED_ENVELOPE calls the 

EnvelopeResponseHandler.postQ method 


The post() method returns no 
exception 


The UICC answers to the 
Envelope with status words 
9000. The data retrieved are 
the ones posted by the 
applet. 



5.5.7 Toolkit Installation 
5.5.7.1 General Behaviour 

Test Area Reference: Cre Tin Genb 



5.5.7.1.1 



5.5.7.1.1.1 



Conformance requirement 
Normal execution 



CRRNl: The UICC Toolkit Application specific parameters (Tag 80h) are mandatory for applications using 
the uicc.toolkit.Toolkitlnterface defined in TS 102 241 [13]. 

CRRN2: Any additional parameters of the UICC Toolkit Application specific parameters field (Tag 80h) shall 
be ignored by the card. 

CRRN3: Some unused byte may be added at the end of the UICC Toolkit Application specific parameters field 
(Tag 80h). 

CRRN4: The UICC Access Application specific parameters (Tag Slh) are applicable to applications using the 
uicc. access. FileView defined in TS 102 241 [13]. 

CRRN5: The UICC Toolkit Application specific parameters field (Tag 80h) is not required for applications 
that do not use the uicc.toolkit.Toolkitlnterface defined in TS 102 241 [13]. 

CRRN6: The UICC Access Application specific parameters field (Tag 81h) is not required for applications 
that a do not use the uicc. access. FileView defined in TS 102 241 [13]. 



5.5.7.1.1.2 

No requirements. 



Parameter errors 



ETSI 



Release 6 



672 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.5.7.1.1.3 

No requirements. 

5.5.7.1.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.1.3 



5.5.7.1.4 



Context errors 
Test area files 

Test_Cre_Tin_Genb .j ava. 

Cre_Tin_Genb_l.java (use uicc.toolkit.Toolkitlnterface). 

Cre_Tin_Genb_2.java (use uicc.access.FileView). 

Cre_Tin_Genb_3.java (use uicc.toolkit.Toolkitlnterface and uicc.access.FileView). 

Cre_tin_genb.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2 


CRRN2 


2 


CRRN3 


2 


CRRN4 


3 


CRRN5 


3 


CRRN6 


1,2 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Good installation with the only tag 80h 

1- Install (install) Appletl with only the 
UICC Toolkit Application specific 
parameters field 




1-RAPDU = 00 90 00 


2 


Good installation with the only tag 80h 

1- Install (install) Appletl with only the 
UICC Toolkit Application specific 
parameters field which contains some 
unused bytes 




1-RAPDU = 00 90 00 


3 


Good installation with the only tag 81 h 

1- Install (install) Applet2 with only the 
UICC Access Application specific 
parameters field 




1-RAPDU = 00 90 00 



5.5.7.2 Timers Allocation 

Test Area Reference: Cre Tin Tmal. 



5.5.7.2.1 



5.5.7.2.1.1 



Conformance requirement 
Normal execution 



CRRNl: One toolkit applet can register to several timers, but a timer can only be allocated to one toolkit 
applet. 



5.5.7.2.1.2 

No requirements. 



Parameter errors 
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5.5.7.2.1.3 



Context errors 



CRRCl: Allocated timers shall not exceed the maximum number of timers allowed for this applet instance 
defined during installation. 

CRRC2: The total number of timers allocated for all the applets shall not exceed 8. If the maximum number of 
timers required is greater than '08' (maximum numbers of timers specified in TS 102 223 [6], the card shall 
return the Status Word '6A80', incorrect parameters in data field, to the Install(Install) command. 



5.5.7.2.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.2.3 



Test area files 

Test_Cre_Tin_Tmal.j ava. 
Cre_Tin_Tmal_ 1 .j a va . 
Cre_Tin_Tmal_2 .Java. 
Cre_Tin_Tmal_3 .j ava. 
Cre_tin_tmal.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


2,3,8 


CRRC1 


1,7 


CRRC2 


4,5,6 



5.5.7.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


IVIore tlian 8 timers at the instantiation of 
Appletl : ctieck that Appletl is not installed. 

1- Install Appletl with maximum 9 timers 
allocated 

2- Appletl is selected 




1 - The installation failed with 
the status word 6A80 

2- Appletl is not found, 
RAPDU != <applet selected 
data> 90 00 




Reset the card 






2 


Good installation of Applet2 

1- Install Applet2 with maximum 4 timers 
allocated 






3 


Allocate 4 timers 
Applet2 

1- An envelope menu selection is send to 
trigger Applet2 

2- Applet2 allocates 4 timers 


2- No exception shall be thrown 




4 


Allocate one more timer 
Applet2 

1- Applet2 allocates one more timer 


1 - Shall throw a ToolkitException 

with reason 

NO TIMER AVAILABLE 




5 


Good installation of applet3 

1- Install Applets with maximum 8 timers 
allocated 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Allocate 4 timers 
Applets 

1- an envelope menu selection is send to 
trigger Applets 

2- Applets allocates 4 timers 


2-No exception shall be thrown 




7 


Allocate one more timer 
Applets 

1- Applets allocates one more timer 


1 - Shall throw a ToolkitException 

with reason 

NO TIMER AVAILABLE 




8 


Check that each timerld (allocated by Applet2 

and applets) is between 1 and 8 and is different 

from each other 







5.5.7.3 Item Identifier 

Test Area Reference: Cre_Tin_Itid 

5.5.7.3.1 Conformance requirement 

5.5.7.3.1.1 Normal execution 

• CRRNl: If the requested item identifier in the range [1 to 127] is not already allocated, then this item identifier 
shall be allocated to the current applet. 

• CRRN2: If the requested item identifier is '00', the card shall take the first free value in the range [128,255]. 

5.5.7.3.1 .2 Parameter errors 

• CRRPl: If the requested item identifier is in the range [128,255], then the card shall reject the install 
command. 



5.5.7.3.1.3 



Context errors 



CRRCl: If the requested item identifier in the range [1 to 127] is already allocated, then the card shall reject 
the install command. 



5.5.7.3.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.3.3 



Test area files 

Test_Cre_Tin_ltid.j ava. 
Cre_Tin_ltid_l .j ava. 
Cre_Tin_ltid_2.j ava. 
Cre_Tin_Itid_3 .j ava. 
Cre_tin_itid.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


2 


CRRN2 


4,5,6 


CRRP1 


1 


CRRC1 


3 
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5.5.7.3.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Bad installation of Appletl 

1- Installation of Appletl 

The following parameters item Id equal to 
128 

2- Appletl is selected 




1 - The installation failed with 
the status word 6A80 

2- Appletl is not found, 
RAPDU 1= <applet selected 
data> 90 00 


2 


Good installation of Appletl 

1- Installation of Appletl 

Item Id = 1 for the first menu and 127 for 
the second one 

2- A Terminal Profile is sent to the card 
with only PROFILE_DOWNLOAD, 

MENU SELECTION, SET UP MENU and 
COMMAND_RESULT facilities. 




2- The UICC answers with 
status words 91 xx to send 
back to the ME the 2 new 
menus 

The menus are 
(position/item Id/text) 
01/01/menu11 
02/127/menu12 


3 


Bad installation of Applet2 
Item identifier already allocated 

1- Installation of Applet2 
item Id = 127 

2- Applet2 is selected 




1 - The installation failed with 
the status word 6A80 

2- Applet2 is not found, 
RAPDU 1= <applet selected 
data> 90 00 


4 


Good installation of Applet2 

1- Installation of Applet2 
item Id = 




1 - The UICC answers with 
status words 91 xx to send 
back to the ME the 3 menus 

The menus are 
01/01/menu11 
02/127/menu12 
03/128/menu21 


5 


Good installation of Applets 

1- Installation of Applets 
item Id = 




1 - The UICC answers with 
status words 91 xx to send 
back to the ME the 4 menus 

The menus are 

01/01/menu11 

02/127/menu12 

03/128/menu21 

04/129/menu31 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Good deletion and installation of Applet2 

1- Delete instance of Applet2 




1- The UICC answers with 
status words 91 xx to send 
back to the ME the 3 menus 




2- Install for install of Applet2 
item Id = 




The menus are 
01/01/menu11 
02/127/menu12 
03/129/menu31 

3- The UICC answers with 
status words 91 xx to send 
back to the ME the 4 menus 

The menus are 

01/01/menu11 

02/127/menu12 

03/128/menu21 

04/129/menu31 



5.5.7.4 Item Position 

Test Area Reference: Cre_Tin_Itpo. 

5.5.7.4.1 Conformance requirement 

5.5.7.4.1.1 Normal execution 

• CRRNl: If the new Menu Entry has to be inserted at an already occupied position, the entries from the 
requested position to the last element of the Menu Entries' list are shifted to the next positions. 

• CRRN2: If the position indicated is greater than the number of elements in the Menu Entries' list, then the 
Menu Entry takes the last position in the Menu Entries' list. 

• CRRN3: If the position indicated is equal to '00', then the Menu Entry takes the last position in the Menu 
Entries' list. 



5.5.7.4.1.2 

No requirements. 

5.5.7.4.1.3 

No requirements. 

5.5.7.4.2 

Test Source: 
Test Applet: 



Cap File: 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Tin_Itpo.j ava. 
Cre_Tin_Itpo_ 1 .j ava. 
Cre_Tin_Itpo_2.j ava. 
Cre_Tin_Itpo_3 .j ava. 
Cre_Tin_Itpo_4.j ava. 
Cre_Tin_Itpo_5 .j ava. 
Cre_Tin_Itpo_6 .j ava. 
Cre_tin_itpo . c ap . 
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5.5.7.4.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 to 10 


CRRN2 


5 


CRRN3 


4 



5.5.7.4.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Installation of Appletl 

1- Install Appletl 

Position/Itemid 

01/01 

02/02 

03/03 

04/04 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus 

The menus are 

(position'^ '/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu13 

04/04/menu14 

'^' position is the position in 
the set up menu proactive 
command 


2 


Installation of Applet2 

1- Install Applet2 

Position/Itemid 

03/05 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 5 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/05/menu21 

04/03/menu13 

05/04/menu14 


3 


Installation of Applets 

1- Install Applet3 

Position/Itemid 

02/06 

03/07 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 7 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/06/menu31 

03/07/menu32 

04/02/menu12 

06/05/menu21 

07/03/menu13 

08/04/menu14 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


4 


Installation of Applet4 

1- Install Applet4 

Position/Itemid 

00/08 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 8 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/06/menu31 

03/07/menu32 

04/02/menu12 

06/05/menu21 

07/03/menu13 

08/04/menu14 

09/08/menu41 


5 


Installation of Applets 

1- Install Applets 

Position/ItemlcJ 

20/09 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 9 menus 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/06/menu31 

03/07/menu32 

04/02/menu12 

06/05/menu21 

07/03/menu13 

08/04/menu14 

09/08/menu41 

10/09/menu51 


6 


Disabling of the first menu of Appletl and 
locking of Applet2 

1- An envelope menu selection is sent with 
Item Id = 02 

2- Appletl disables its first menu {Item 
Id = 01) 

3- Lock the Applet2 


1- Appletl is triggered 


2- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 08 menus 

The menus are 

(position/item Id/text) 

01/06/menu31 

02/07/menu32 

03/02/menu12 

05/05/menu21 

06/03/menu13 

07/04/menu14 

08/08/menu41 

09/09/menu51 

3- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 07 menus 

The menus are 
(position/item Id/text) 
01/06/menu31 
02/07/menu32 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



03/02/menu12 
05/03/menu13 
06/04/menu14 
07/08/menu41 
08/09/menu51 



Installation of Applet6 



1- Install Applete 

Position/Itemid 

01/10 

04/11 

15/12 



1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 10 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/06/menu31 

03/11 /menu62 

04/07/menu32 

05/02/menu12 

07/03/menu13 

08/04/menu14 

09/08/menu41 

10/09/menu51 

11/12/menu63 



Enabling of the first menu of Appletl and 
unlocking of Applet2 

1- An envelope menu selection is sent with 
Item Id = 02 

2- Appletl enables its first menu {Item Id 
= 01) 



1- Appletl is triggered 



3- Unlock the Applet2 



2- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 1 1 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/06/menu31 

04/11/menu62 

05/07/menu32 

06/02/menu12 

08/03/menu13 

09/04/menu14 

10/08/menu41 

11/09/menu51 

12/12/menu63 

3- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 12 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/06/menu31 

04/11/menu62 

05/07/menu32 

06/02/menu12 

08/05/menu21 

09/03/menu13 

10/04/menu14 

11/08/menu41 

12/09/menu51 

13/12/menu63 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


09 


Deletion of Applet2 

1- Delete Applet2 




1 - The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 11 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/08/menu31 

04/11/menu62 

05/07/menu32 

06/02/menu12 

08/03/menu13 

09/04/menu14 

10/08/menu61 

11/09/menu51 

12/12/menu63 


10 


Installation of Applet2 

1- Install Applet2 

Position/ltemlcJ 

03/05 




1- The UICC answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 12 menus 

The menus are 

(position/item Id/text) 

01/10/menu61 

02/01/menu11 

03/05/menu21 

04/06/menu31 

05/11/menu62 

06/07/menu32 

07/02/menu12 

09/03/menu13 

10/04/menu14 

11/08/menu41 

12/09/menu51 

13/12/menu63 



5.5.7.5 Maximum Text Length for a menu entry 

Test Area Reference: Cre_Tin_Mlme. 

5.5.7.5.1 Conformance requirement 

5.5.7.5.1.1 Normal execution 

• CRRNl: The maximum length of item text string is defined at the installation of the toolkit applet. 

5.5.7.5.1.2 Parameter errors 

• CRRPl : If initMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 

• CRRP2: If changeMenuEntry length parameter is greater than the allocated space (Maximum Text Length for 
a menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 



5.5.7.5.1.3 

No requirements. 



Context errors 
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5.5.7.5.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.7.5.3 



Test area files 

Test_Cre_Tin_Mlme.j ava. 
Cre_Tin_Mlme_ 1 .j ava. 
Cre_tin_mlme.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,3,4 


CRRP1 


2 


CRRP2 


5 



5.5.7.5.4 



Test procedure 



id 


Description 


API / Framework Expectation 


APDU Expectation 


1 


Installation of applet with 2 menus not 
exceeding the maximum text length 

Install one applet with 3 menu entries 
allowed and max. text length equal to 10. 
initMenuEntry defined at the install 
(install) command 

MenuEntry = "MenuEntryl", "MenuEntry2" 
Offset = 
Length =10 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 






2 


InitMenuEntry with a too large length 

initMenuEntry with length equal to 11 

MenuEntry = " MenuEntry03" 

Offset = 

Length = 11 

NextAction = ' 00 ' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 




3 


initMenuEntry with a right length 

initMenuEntry with length parameter equal 

to 10 

MenuEntry = " MenuEntry3" 

Offset = 

Length =10 

NextAction = ' 00 ' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 




a SET UP MENU (3 items) 
is issued witli TLV item 
lengtli equal to 1 1 (Identifier 
-1- Text string of item) 


4 


ChangeMenuEntry with a right length 

Appletl is triggered by a 

EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 

parameter equal to 10 

Id = '01' 

MenuEntry = "MenuEntry4" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 

Return from processToolkit 




a SET UP MENU (3 items) 
is issued witli TLV item 
length equal to 1 1 (Identifier 
-1- Text string of item) 
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Id 


Description 


API / Framework Expectation 


APDU Expectation 


5 


changeMenuEntry with a too large length 








Appletl is triggered by a 
EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 
parameter equal to 11 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 


SW = 90 00 




Id = '02' 








MenuEntry = "MenuEntryOS" 








Offset = 








Length = menuEntry. length 








NextAction = 








HelpSupported = false 
IconQualif ier = 








Iconldentif ier = 








Return from processToolkit 







5.5.7.6 Maximum number of menu entries 

Test Area Reference: Cre Tin Nbme. 



5.5.7.6.1 



5.5.7.6.1.1 



Conformance requirement 



Normal execution 



CRRNl: The maximum number of menu entries is defined at the installation of the toolkit applet and can be 
the maximum number of successful invocations of the method initMenuEntry. 



5.5.7.6.1.2 



Parameter errors 



CRRPl: If the menu entry cannot be initialized (e.g. no more item data in applet loading parameter), a 
ToolkitException with the REGISTRY_ERROR reason code is thrown. 



5.5.7.6.1.3 

No requirements. 

5.5.7.6.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.7.6.3 



Context errors 
Test area files 

Test_Cre_Tin_Nbme.j ava. 
Cre_Tin_Nbme_l .Java. 
Cre_Tin_Nbme_2.j ava. 
Cre_tin_nb me . cap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRP1 


2,3 
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5.5.7.6.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Installation of applet with 3 menus 

Install (install) applet with max. number 
of menu entry is ' 3 ' , defined at the 
install (install) command. 

initMenuEntry for each menu entry allowed 
(3 times) 

MenuEntry = "menul", "menu2", "menu3" 
Offset = 
Length = 5 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No Exception is thrown 




2 


init of a 4'" menu 

initMenuEntry one more time 
MenuEntry = "menu4" 
Offset = 
Length = 5 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


SET UP MENU (3 items: 
"menul", "menu2", "menu3") 


3 


Installation of 2"° applet with menu 

1- Install (install) another applet, with 
max. number of menu entry is '0', defined 
at the install (install) command. 

initMenuEntry once 
MenuEntry = "menus " 
Offset = 
Length = 5 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- Perform a RESET and a Terminal Profile 
with the facilities of PROFILE DOWNLOAD, 
MENU_SELECTION, COMMAND_RESULT and 

SET UP MENU 


ToolkitException 
REGISTRY_ERROR is thrown 


2- SET UP MENU (3 items: 
"menul", "menu2", "menu3") 



5.5.7.7 Access Domain 

Test Area Reference: Cre_Tin_Acdo. 



5.5.7.7.1 



Conformance requirement 



5.5.7.7.1.1 



Normal execution 



CRRNl: The UICC access specific parameters (Tag 80h) indicate the mechanism used to control the 
application instance access to the File System ('00' means full access to the File System, '02' means UICC 
access mechanism and 'FF' means no access to the File System). 

CRRN2: The UICC access specific parameters are applicable to applications using the uicc. access. FileView 
defined in TS 102 241 [13]. 

CRRN3: The UICC administrative access parameter (Tag 83h) indicate the mechanism used to control the 
application instance access to the File System ('00' means full access to the File System, '02' means UICC 
access mechanism and 'FF' means no access to the File System). 

CRRN4: The UICC administrative access parameters are applicable to applications using the 
uicc.access.fileadministration.AdminFileView defined in TS 102 241 [13]. 
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CRRN5: If an application has Access Domain Parameter '00' (i.e. Full Access to the File System), all actions 
can be performed on a file except the ones with NEVER access condition. 

CRRN6: If an application has Access Domain Parameter '02' (i.e. UICC access mechanism). The UICC access 
mechanism shall be coded as follows: 



Byte 1 



b8 



b7 



b6 



b5 



b4 



b3 



b2 



b1 



Application PIN 1 
Application PIN 2 
Application PIN 3 
Application PIN 4 
Application PIN 5 
^Application PIN 6 
Application PIN 7 
Application PIN 8 



Byte 2 



bS b7 b6 b5 b4 bS b2 



b1 



ADM1 
"ADM2 
"ADM3 
"ADM4 
"ADM5 
"ADM6 
"ADM7 
"ADM8 



Byte 3 



b8 



b7 



b6 



b5 



b4 



b3 



b2 



b1 



ADM9 
"ADM10 

Always 

Local PIN ( only applicable for ADF ) 
"RFU 

"rfu 
"rfu 
"rfu 



These access rights shall be checked against SE ID 01 access rules as defined in TS 102 221 [5]. 



5.5.7.7.1.2 



Parameter errors 



• CRRPl: If the Access Domain Parameter requested is not supported, the card shall return the Status Word 
'6A80', incorrect parameters in data field, to the Install(Install) command. 

• CRRP2: If an application with Access Domain Parameter 'FF' (i.e. No Access to the File System) tries to 
access a file the CAT Runtime Environement shall throw a UICCException with a 
SECURITY_STATUS_NOT_SATISFIED reason. 

• CRRP3: If an application with Access Domain Parameter '02' (i.e. UICC access mechanism) tries to access a 
file without the correct rights, the CAT Runtime Environement shall throw a UICCException with a 
SECURITY STATUS NOT SATISFIED reason. 



5.5.7.7.1.3 

No requirements. 



Context errors 
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5.5.7.7.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.7.3 



Test area files 

Test_Cre_Tin_Acdo .j ava. 
Cre_Tin_Acdo_ 1 .j ava. 
Cre_Tin_Acdo_2 .j ava. 
Cre_Tin_Acdo_3 .j ava. 
Cre_Tin_Acdo_4.j ava. 
Cre_Tin_Acdo_5 .j ava. 
Cre_Tin_Acdo_6 .j ava. 
Cre_Tin_Acdo_7 .j ava. 
Cre_Tin_Acdo_8 .j ava. 
Cre_tin_acdo.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 to 6 


CRRN2 


1 to 6 


CRRN3 


1 to 6 


CRRN4 


1 to 6 


CRRN5 


1 


CRRN6 


3 to 6 


CRRP1 


Not tested 


CRRP2 


2 


CRPP3 


3 to 6 



5.5.7.7.4 Test procedure 

The following table summarizes tests performed in the test procedure. 





Cyclic files (EFcarrx) 






Linear fixed files(EFLARRx) 








Transparent files(EFTARRx) 








Applet 
rights 


File rights 


Activate 


Deactivate 


Read 
BIn/Rec 


Update 
BIn/Rec 


Search 


Increase 


Create 


Delete 


Resize 


Full 
access 


Always 

(EFxARRi) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Global PIN1 1 
ADM1 

(EFxARR4) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 
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Cyclic files (EFcarrx) 






Linear fixed files(EFLARRx) 








Transparent files{EFTARRx) 








Applet 
rights 


File rights 


Activate 


Deactivate 


Read 
Bin/Rec 


Update 
Bin/Rec 


Search 


Increase 


Create 


Delete 


Resize 


No 
Access 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 1 
ADM1 

(EFxARR4) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Always 


Always 

(EFxARRi) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 1 
ADM1 

(EFxARR4) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global 
PIN1 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 1 
ADM1 

(EFxARR4) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global 
PIN1 & 
ADM1 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 
&ADM1 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Global PiN1 1 
ADM1 

(EFxARR4) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local 
PIN& 
ADM2 


Always 

(EFxARRi) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Never 

(EFxARR2) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 
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Cyclic files (EFcarrx) 






Linear fixed files(EFLARRx) 








Transparent files(EFTARRx) 








Applet 
rights 


File rights 


Activate 


Deactivate 


Read 
Bin/Rec 


Update 
Bin/Rec 


Search 


Increase 


Create 


Delete 


Resize 




Global PIN1 
&ADM1 

(EFxARRs) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Global PIN1 1 
ADM1 

(EFxARR4) 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


NOK 


Local PIN 1 / 
ADM2 (See 
note) 

(EFxARRs) 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


OK 


NOTE: For EFxarrs, the file access condition is Local PIN 1 if the file is located under the MP and ADM2 if it is 
located under ADP1 . 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Full access Applet 

0- Appletl installation 
with full access right 

1- Send an envelope Menu 
Selection to trigger 
Appletl on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Appletl on menu Id 2 



1- Appletl is triggered and gets Fileviews on UICC and 
ADF1 

1 .1 - For each EFcarrx Appletl calls all associated 
methods with success, except on file EFcarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .2- For each EFlarrx Appletl calls all associated 
methods with success, except on file EFlarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .3- For each EFtarrx Appletl calls all associated 
methods with success, except on file EFtarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2- Appletl is triggered and gets AdminFlleviews on 
UICC and ADF1 

2.1- For each EFcarrx Appletl calls all associated 
methods with success, except on file EFcarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.2- For each EFlarrx Appletl calls all associated 
methods with success, except on file EFlarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.3- For each EFtarrx Appletl calls all associated 
methods with success, except on file EFtarr2 where 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.4- Under each DFarrx Appletl resize the EFtarxt with 
success, except on file EFtar2t where an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown. 

2.5- Under each DFarrx Appletl delete the EFtarxt with 
success, except on file EFtar2t where an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown. 

2.6- Under each DFarrx Appletl create the EFtarxt with 
success, except under DFarr2 where an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown at creation of a file similar to EFtar2t. 



1-SW = 90 00 



2- SW = 90 00 



Appletl deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



No access Applet 

0- Applet2 installation 
with no access right 

1- Send an envelope Menu 
Selection to trigger 
Applet2 on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applet2 on menu Id 2 



3- Applet2 deletion 



1- Applet2 is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For each EFcarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .2- For each EFlarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

1 .3- For each EFtarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2- Applet2 is triggered and gets AdminFlleviews on 
UICC and ADF1 

2.1- For each EFcarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.2- For each EFlarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.3- For each EFtarrx Applet2 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.4- Under each DFarrx Applet2 resize the EFtarxt; 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.5- Under each DFarrx Applet2 delete the EFtarxt; 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 

2.6- Under each DFarrx Applet2 create an EF; 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown. 



1-SW = 90 00 



2- SW = 90 00 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Always access right Applet 

0- Applets installation 
with Always access right 

1- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 2 



1- Applets is triggered and gets Fileviews on UICC and 
ADF1 

1.1- For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarri where the execution 
is successful. 

1 .2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarri where the execution is 
successful. 

1 .S- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarri where the execution is 
sucessful. 

2- Applets is triggered and gets AdminFlleviews on 
UICC and ADF1 

2.1- For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarri where the execution 
is successful. 

2.2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarri where the execution is 
successful. 

2.S- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarri where the execution is 
sucessful. 

2.4- Under each DFarrx Applets resize the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtaru where the execution is 
successful. 

2.5- Under each DFarrx Applets delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtaru where the execution is 
successful. 

2.6- Under each DFarrx Applets create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtaru where the execution is 
successful. 



1-SW = 90 00 



2- SW = 90 00 



S- Applets deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Global PIN1 access right 
Applet 

0- Applet4 installation 
with Global PINl access 
right 

1- Send an envelope Menu 
Selection to trigger 
Applet4 on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applet4 on menu Id 2 



1- Applet4 is triggered and gets Filevlews on UICC and 
ADF1 

1 .1 - For each EFcarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarr4 where the execution 
is successful. 

1 .2- For each EFlarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarr4 where the execution is 
successful. 

1 .3- For each EFtarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarr4 where the execution is 
sucessful. 

2- Applet4 is triggered and gets AdminFlleviews on 
UICC and ADF1 

2.1- For each EFcarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarr4 where the execution 
is successful. 

2.2- For each EFlarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarr4 where the execution is 
successful. 

2.3- For each EFtarrx Applet4 calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarr4 where the execution is 
sucessful. 

2.4- Under each DFarrx Applet4 resize the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtar4t where the execution is 
successful. 

2.5- Under each DFarrx Applet4 delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtar4t where the execution is 
successful. 

2.6- Under each DFarrx Applet4 create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtar4t where the execution is 
successful. 



1-SW = 90 00 



2- SW = 90 00 



3- Applet4 deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Global PIN1 & ADM1 access 
right Applet 

0- Applets installation 
with Global PINl & ADMl 
access right 

1- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 2 



1- Applets is triggered and gets Filevlews on UICC and 
ADF1 

1 .1 - For each EFCARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

1 .2- For each EFLARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

1 .3- For each EFTARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is sucessful. 

2- Applet3 is triggered and gets AdminFileviews on 
UICC and ADF1 

2.1- For each EFCARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFcarrs and EFcarr4 where 
the execution Is successful. 

2.2- For each EFLARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

2.3- For each EFTARRx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on files EFCARR3 and EFCARR4 
where the execution is sucessful. 

2.4- Under each DFARRx Applets resize the EFTARxT; 
an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on files EFCARR3 and EFCARR4 
where the execution is successful. 

2.5- Under each DFARRx Applets delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on files EFcarrs and EFcarr4 where 
the execution is successful. 

2.6- Under each DFARRx Applets create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on files EFcarrs and EFcarr4 where 
the execution is successful. 



1-SW = 90 00 



2- SW = 90 00 



3- Applets deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



Local Pin & ADM2 access right 
Applet 

0- Applets installation 
with Local PIN & ADM2 
access right 

1- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 1 



2- Send an envelope Menu 
Selection to trigger 
Applets on menu Id 2 



1- Applets is triggered and gets Fllevlews on UICC and 
ADF1 

1 .1 - For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFqarrs where the execution 
is successful. 

1 .2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarrs where the execution is 
successful. 

1 .3- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarrs where the execution is 
sucessful. 

2- Applets is triggered and gets AdminFlleviews on 
UICC and ADF1 

2.1- For each EFcarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFcarrs where the execution 
is successful. 

2.2- For each EFlarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFlarrs where the execution is 
successful. 

2.3- For each EFtarrx Applets calls all associated 
methods; 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
are thrown, except on file EFtarrs where the execution is 
sucessful. 

2.4- Under each DFarrx Applets resize the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtarst where the execution is 
successful. 

2.5- Under each DFarrx Applets delete the EFtarxt; an 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtarst where the execution is 
successful. 

2.S- Under each DFarrx Applets create an EF like the 
EFtarxt; an 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown, except on file EFtarst where the execution is 
successful. 



1-SW = 90 00 



2- SW = 90 00 



3- Applets deletion 
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Id 



Description 



API/CAT RE Expectation 



APDU Expectation 



AdminFileview and Fileview 

acces domain parameter 

differenciation 

0- AppletV installation 
with Always & ADMl access 
right for Fileview access 
domain 

1- Send an envelope Menu 
Selection on menu id 1 to 
trigger AppletV 



1- Applet? is triggered and gets Fileview on UICC. 

1.1- Using the Fileview, Applet? reads file EFtarrl No 
exception is expected 

1 .2- Using the Fileview, Applet? reads file EFtarrs- An 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown 

1 .3- Using the Fileview, Applet? reads file EFtarr4- No 
exception is expected 



1-SW = 90 00 



2- AppletV deletion 

3- AppletV installation 
with Global PINl & ADM2 
access right for 
AdminFileview access domain 

4- Send an envelope Menu 
Selection on menu id 2 to 
trigger AppletV 



5- AppletV deletion 

6- AppletV installation 
with Always & ADMl access 
right for Fileview access 
domain and Global PINl & 
ADM2 access right for 
AdminFileview access 
domain, 

V- Send an envelope Menu 
Selection on menu id 3 to 
trigger AppletV 



8- Applet? deletion 



4- Applet? is triggered and gets AdminFileview on UICC. 

4.1- Using the AdminFileview, Applet? reads file 
EFtarrl An 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown 

4.2- Using the AdminFileview, Applet? reads file 
EFtarrb. No exception is expected 

4.3- Using the AdminFileview, Applet? reads file 
EFtarr4. No exception is expected 



4- SW = 90 00 



?- Applet? is triggered and gets Fileview and 
AdminFileview on UICC. 

?.1- Using the Fileview, Applet? reads file EFtarrl No 
exception is expected 

?.2- Using the AdminFileview, Applet? reads file 
EFtarrl An 

UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown 

?.3- Using the AdminFileview, Applet? reads file 
EFtarr5. No exception is expected 

?.4- Using the Fileview, Applet? reads file EFtarrs- An 
UICCException.SECURITY_STATUS_NOT_SATISFIED 
is thrown 

?.5- Using the Fileview, Applet? reads file EFtarr4. No 
exception is expected 

?.6- Using the AdminFileview, Applet? reads file 
EFtarr4. No exception is expected 



?- SW = 90 00 
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5.5.7.8 Priority Level 

Test Area Reference: Cre_Tin_Prlv. 

5.5.7.8.1 Conformance requirement 

5.5.7.8.1.1 Normal execution 

• CRRN 1 : The priority specifies the order of activation of an applet compared to the other applet registered to 
the same event ('01': Highest priority level, 'FF' : Lowest priority level). 

• CRRN2: If two or more applets are registered to the same event and have the same priority level, the applets 
are activated according to their installation date (i.e. the most recent applet is activated first). 



5.5.7.8.1.2 

No requirements. 

5.5.7.8.1.3 

No requirements. 

5.5.7.8.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.7.8.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Tin_Prlv_x.java, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB. 
Cre_Tin_Prlv_x.java, x from 1 to 12, 8A, SB, 9A, 9B, lOA, lOB. 
Cre_tin_prlv_x.cap, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2,3,4,6,8, 10, 12 


CRRN2 


5,7,9,11 



5.5.7.8.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





All applets are registered on an 

EVENT EVENT DOWNLOAD USER ACTIVITY event 






1 


Trigger 2 applets with 2 different maximum 
Priority Levels 

1- Install (install) Appletl with priority 
level ' 2 ' and Applet2 with priority level 
'1', from package Cre tin_prlv_l 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


Trigger 2 applets with 2 different maximum 
Priority Levels 

1- Install (install) Appletl with priority 
level '1' and Applet2 with priority level 
'2', from package Cre tin prlv 2. 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event . 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Appletl is 
triggered before Applet2 




3 


Trigger 2 applets with 2 different Priority 
Levels 

1- Install (install) Appletl with 
priority level '80' and Applet2 with 
priority level '7F', from package 
Cre tin prlv 3 . 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




4 


Trigger 2 applets with 2 different Priority 
Levels 

1- Install (install) Appletl with 
priority level '7F' and Applet2 with 
priority level '80', from package 
Cre tin prlv 4 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




5 


Trigger 3 applets with the same Priority Level 

1- Install (install) applet 1, 2, 3 in 
this order with same priority level from 
package Cre tin prlv 5 

2- Send an Envelope that triggers the 3 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applets is 
triggered before Applet2, and 
Applet2 is triggered before Appletl 




6 


Trigger 2 applets from 2 classes, with 2 
different Priority Level 

1- Install (install) Appletl from class A 
with priority level ' 2 ' 

Install (install) Applet2 from class B 
with priority level '1' 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


7 


Trigger 2 applets from 2 classes, with the same 
Priority Level 

1- Install (install) Appletl from class A 
with priority level ' 1 ' 

Install (install) Applet2 from class B 
with priority level ' 1 ' 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




8 


Trigger 2 applets from 2 packages, with 2 
different Priority Level 

1- Install package Cre tin prlv 8. 
Install (install) Appletl from package 
Cre_tin_prlv_8A with priority level '2' 
Install (install) Applet2 from package 
Cre tin prlv 8B with priority level '1' 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances ad packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




9 


Trigger 2 applets from 2 packages, with the 
same Priority Level 

1- Install package Cre_tin_prlv_9 . 
Install (install) Appletl from package 
Cre_tin_prlv_9A and Applet2 from package 
Cre tin prlv 9B in this order, with same 
priority level 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Applet2 is 
triggered before Appletl 




10 


Trigger 4 applets from 2 packages 

1- Install packages Cre tin_prlv_10, 
Cre_tin_prlv_10A and Cre_tin_prlv_10B 
Install (install) 2 applets 1 then 2 from 
package Cre_tin_prlv_10A, with 
respectively priority levels 1 and 2 

2- Send an Envelope that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Install (install) 2 applets 3 then 4 
from package Cre tin prlv lOB, with 
respectively priority levels 1 and 2 

4- Send an Envelope that triggers the 4 
applets 

5- Delete applets instances and packages 


2- A static variable is used to 
validate triggering order: Appletl 
is triggered before Applet2 

4- Applets is triggered before 
applets 1 , 4, then 2 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


11 


Trigger 4 applets with the same Priority Level 

then delete them one after another and trigger 

them each time 

1- Install (install) applets 1, 2, 3, 4 in 
this order with same priority level from 
package Cre tin prlv 11 

2- Send an Enveloppe that triggers the 4 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applet instance 4 

4- Send an Enveloppe that triggers the 3 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

5- Delete applet instance 3 

6- Send an Enveloppe that triggers the 2 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

7- Delete remaining applet instances and 
packages 


2- A static variable is used to 
validate triggering order: applets 
are triggered in order 4, 3, 2, 1 

4- Applets are triggered in order 3, 
2, 1 

6- Applets are triggered in order 2, 
1 




12 


Trigger 5 applets with different Priority Levels, 
alternating install and delete 

1- Install (install) applets 1, 2, 3, 4 in 
this order with respective priority levels 
1, 2, 1, 2 

2- Send an Enveloppe that triggers the 4 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

3- Delete applet instance 1 and install 
(install) applets with priority level 2 

4- Send an Enveloppe that triggers the 4 
applets with the 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY event 

5- Re-install (install) Appletl with 
priority level 1 

6- Send an Enveloppe that triggers the 5 
applets with the 

EVENT EVENT DOWNLOAD USER ACTIVITY event 


2- A static variable is used to 
validate triggering order: applets 
are triggered in order 3, 1 , 4, 2 

4- Applets are triggered in order 3, 
5,4,2 

6- Applets are triggered in order 1 , 
3, 5, 4, 2 





5.5.7.9 Channel Allocation 

Test Area Reference: Cre Tin Chal. 



5.5.7.9.1 



5.5.7.9.1.1 



Conformance requirement 
Normal execution 



CRRNl: One toolkit applet can register to several channels, but a channel can only be allocated to one toolkit 
applet. 



5.5.7.9.1.2 

No requirements. 



Parameter errors 
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5.5.7.9.1.3 



Context errors 



CRRCl : Allocated channels shall not exceed the maximum number of channels allowed for this applet 
instance. 

CRRC2 : The total number of channels allocated for all the applets shall not exceed 7. If the maximum number 
of channels required is greater than '07' (maximum numbers of channels specified in TS 102 223 [6]), the card 
shall return the Status Word '6A80', incorrect parameters in data field, to the Install(Install) command. 



5.5.7.9.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.9.3 



Test area files 

Test_Cre_Tin_Chal.j ava. 
Cre_Tin_Chal_l .Java. 
Cre_Tin_Chal_2.java. 
Cre_Tin_Chal_3 .j ava. 
Cre_tin_chal.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


2,3 


CRRC1 


1,7 


CRRC2 


4,5,6 



5.5.7.9.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


IVIore than 7 channels at the instantiation of 
Appletl : check that Appletl is not installed 

l-Install for install of Appletl with 
maximum 8 channels allocated 

2- Select the Appletl 




2- SW = 6A 80 




Reset the card 






2 


Good installation of Applet2 

Install for install of Applet2 {maximum 4 
channels allocated) . 




The Dice answers with 
status words 90 00 


3 


Open 4 channels 
Applet2 

Applet2 builds a proactive command OPEN 
CHANNEL 4 times, calling init ( ) and send{) 
methods . 


No exception shall be thrown. 


OPEN CHANNEL proactive 
command are fetched. 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL are sent to the 
UICC with Channel Id = 01 
to 04 


4 


Open one more channel 
Applet2 

Applet2 builds a proactive command OPEN 
CHANNEL once again, calling init{) and 
sendO methods 


Shall throw a ToolkitException with 

reason 

COMMAND NOT ALLOWED 




5 


Good installation of applets 

Install for install of Applets {maximum 7 
channels allocated) 




The UICC answers with 
status words 90 00 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


Open 3 ciiannels 
Applet3 

Applets builds a proactive command OPEN 
CHANNEL 3 times, calling init { ) and send{) 
methods 


No exception shall be thrown. 


OPEN CHANNEL proactive 
command is fetched 

Successful TERMINAL 
RESPONSE of OPEN 
CHANNEL are sent to the 
UICC with Channel Id from 
05 to 07 


7 


Open one more cliannel 
Applet3 

Applets builds a proactive command OPEN 
CHANNEL once again, calling initO and 
send{) methods 


No exception shall be thrown. 


OPEN CHANNEL proactive 
command is fetched. 
Unsuccessful Terminal 
Response is sent to the 
UICC with 'No Channel 
Available' as Additional 
Information on Result 



5.5.7.10 Minimum Security Level 

Test Area Reference: Cre_Tin_Mslv. 



5.5.7.10.1 



Conformance requirement 



5.5.7.10.1.1 



Normal execution 



CRRNl: The Receiving Entity shall check the Minimum Security Level during processing the security of the 
Command Packet. 

CRRN2: The Receiving Entity shall reject the message if the MSL check fails. 

CRRN3: If the check fails, the Receiving Entity shall reject the messages and a Response Packet with the 
'Insufficient Security Level' Response Status Code shall be sent if required. 

CRRN4: If the length of the Minimum Security Level field is greater than zero, the Minimum Security Level 
is used to specify the minimum level of security to be applied to Secured Packets. The first byte shall be the 
MSL Parameter, other bytes shall be the MSL Data. 

CRRN5: If the length of the Minimum Security Level field is zero, no minimum security level check shall be 
performed by the receiving entity. 



5.5.7.10.1.2 
No requirements. 

5.5.7.10.1.3 
No requirements. 



Parameter errors 



Context errors 



5.5.7.10.2 
None. 



Test area files 
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5.5.7.10.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


Not applicable 


CRRN2 


Not applicable 


CRRN3 


Not applicable 


CRRN4 


Not applicable 


CRRN5 


Not applicable 



5.5.7.10.4 Test procedure 

Not applicable. 

5.5.7.1 1 TAR Value(s) of the Toolkit Application instance 

Test Area Reference: Cre_Tin_Tarv. 

5.5.7.1 1.1 Conformance requirement 

5.5.7.11.1.1 Normal execution 

• CRRNl: It is possible to define several TAR Values at the installation of a Toolkit Application. 

• CRRN2: If the length of TAR Value(s) is zero, the TAR may be taken out of the AID, if any. 

• CRRN3: If the length of the TAR Value(s) is greater than zero then the application instance shall be installed 
with the TAR Value(s) field defined above and the TAR indicated in the AID if any shall be ignored. 



5.5.7.11.1.2 
No requirements. 

5.5.7.11.1.3 



Parameter errors 



Context errors 



• CRRCl If a TAR Value(s) is already assigned on the card for a Toolkit Application instance, the card shall 
return the Status Word '6A80', incorrect parameters in data field, to the INSTALL [for install] command. 

• CRRCl If the length of TAR Value(s) field is incorrect, the card shall return the Status Word '6A80', incorrect 
parameters in data field, to the INSTALL [for install] command. 



5.5.7.11.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.7.11.3 



Test area files 

Test_Cre_Tin_Tarv.j ava. 
Cre_Tin_Tarv_l .Java. 
Cre_Tin_Tarv_2.java. 
Cre_tin_tarv. cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 (but partially tested only) 


CRRN2 


Not applicable 


CRRN3 


Not applicable 


CRRC1 


1 


CRRC2 


2 
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5.5.7.11.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


TAR value(s) already allocated 

1- Install Applet2 with the TAR "020202" 

2- Install Appletl with the TAR values: 
"010101" 

"020202" 
"030303" 




1-SW = RAPDU = 00 90 00 
2- SW = 6A 80 


2 


Bad TAR value(s) 

1- Install Appletl with the TAR values: 

"010101" 

"0303" 




1-SW = 6A80 



5.5.7.12 Services Allocation 

Test Area Reference: Cre_Tin_Sval. 

5.5.7.12.1 Conformance requirement 

5.5.7.12.1.1 Normal execution 

• CRRNl: One toolkit applet can allocates several services, but a service can only be allocated to one toolkit 
applet. 



5.5.7.12.1.2 
No requirements. 

5.5.7.12.1.3 



Parameter errors 



Context errors 



CRRCl: Allocated services shall not exceed the maximum number of services allowed for this applet instance 
defined during installation. 

CRRC2: The total number of services allocated for all the applets shall not exceed 8. If the maximum number 
of services required is greater than '08' (maximum numbers of services specified in TS 102 223 [6]), the card 
shall return the Status Word '6A80', incorrect parameters in data field, to the Install(Install) command. 



5.5.7.12.2 

Test Source: 
Test Applet: 



Cap File: 
5.5.7.12.3 



Test area files 

Test_Cre_Tin_Sval.java. 
Cre_Tin_Sval_l .Java. 
Cre_Tin_Sval_2.java. 
Cre_Tin_S val_3 .j ava. 
Cre_tin_sval.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


2,3,8 


CRRC1 


1,7 


CRRC2 


4,5,6 



ETSI 



Release 6 



703 



ETSI TS 102 268 V6.1.0 (2013-06) 



5.5.7.12.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


More than 8 services at the instantiation of 
Appletl : check that Appletl is not installed. 

1- Install Appletl with maximum 9 services 
allocated 




1 - SW = 6A 80 




Reset the card 






2 


Good installation of Applet2 

1- Install Applet2 with maximum 4 services 
allocated 




1-RAPDU = 00 90 00 


3 


Allocate 4 services 
Applet2 


No exception shall be thrown 




4 


Allocate one more service 
Applet2 


Shall throw a ToolkitException with 

reason 

NO_SERVICE_ID_AVAILABLE 




5 


Good installation of applet3 

1- Install Applets with maximum 8 services 
allocated 




1- RAPDU = 00 90 00 


6 


Allocate 4 services 
Applet3 


No exception shall be thrown 




7 


Allocate one more service 
Applets 


Shall throw a ToolkitException with 

reason 

NO_SERVICE_ID_AVAILABLE 




8 


Check that each service identifier (allocated by 

Applet2 and applets) is between and 7 and is 

different from each other 







5.5.8 UICC File Access 
5.5.8.1 FileView 

Test Area Reference: Cre_Ufa_View. 



5.5.8.1.1 



Conformance requirement 



5.5.8.1 .1 .1 Normal execution 

• CRRNl: Any Applet (not only Toolkit Applets) is allowed to retrieve and use a FileView. 

• CRRN2: The UICC FileView can be retrieved by invoking the getTheUICCView() method from the 
UlCCSystem. 

• CRRN3: An ADF FileView can be retrieved by invoking the getTheFileView(...) method with passing as 
parameter the full AID of the application owning the ADF. 

• CRRN4: The UICC FileView allows to access the MP and all DFs and EFs that are located under the MF, 
including DF Telecom and any access technology specific DF located under the MF, but not the files located 
under any ADF. 

• CRRN5: An ADF FileView allows to access only the DFs and EFs located under the ADF. 

• CRRN6; Each FileView object shall be provided as a permanent JCRE entry point object. 
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CRRN7: A separate and independent file context shall be associated with each and every FileView object: the 
operation performed on files in a given FileView object shall not affect the file context associated with any 
other FileView object. 

CRRN8: The file context can be transient or persistent depending on what was required by the Applet during 
the creation of the FileView object. 

CRRN9: Each FileView shall be given the access control privileges associated with the UICC File System or 
the corresponding ADF for the Applet. 

CRRNIO: The access control privileges are checked each time a method of the FileView object is invoked. The 
access control privileges are defined by the access domain parameters specified in TS 102 226 [8]. 

CRRN 1 1 : The root of the context of a FileView object is the MF for the UICC FileView. 

CRRN12: The root of the context of a FileView object is the ADF for an ADF FileView. 

CRRN 13: When the transient context of a FileView is cleared, the current DF becomes the root of the 

FileView. 



5.5.8.1.1.2 

No requirements. 



Parameter errors 



5.5.8.1.1.3 Context errors 

• CRRCl : It is not possible to access the MF or any DF or EF located under the MF from an ADF FileView. 



5.5.8.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.8.1.3 



Test area files 

Test_Cre_Ufa_View.j ava. 
Cre_Ufa_View_l .Java. 
Cre_uf a_vie w . c ap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2,3 


CRRN2 


1 , 2, 3 and see also Api 1 Cent test cases for CRRN 1 


CRRN3 


1 , 2, 3 and see also Api 1 Cent test cases for CRRN 1 


CRRN4 


2 and see also Api 1 Cont test cases for CRRN1 


CRRN5 


3 and see also Api 1 Conttest cases for CRRN 1 


CRRN6 


4 


CRRN7 


5, 7 and see also Api 1 Cont test cases for CRRN 1 


CRRN8 


6 


CRRN9 


See Cre Tin Acdo 


CRRN10 


See Cre Tin Acdo 


CRRN11 


5,6 


CRRN12 


5,6 


CRRN13 


6 


CRRCl 


3 
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5.5.8.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Applets can get a FileView 

1- A toolkit applet, Appletl, anc3 a non 
toolkit applet, Applet2, are installed 
with full access to the file system 

2- An envelope menu selection is sent to 
trigger Appletl 

3- Appletl gets the UICC FileView using 
methoca getUICCFileView { ) ancJ the ADFl 
FileView getTheFileView { ) 

4- Senca an APDU to trigger Applet2 

5- Applet2 gets the UICC FileView using 
methoca getUICCFileView { ) ancJ the ADFl 
FileView getTheFileView { ) 


2- Appletl is triggered 

3- No exception is thrown 

4- Applet2 is triggered 

5- No exception is thrown 




2 


Applets can only access all files under the MF 
using the UICC file view 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets the UICC FileView 

3- Appletl selects the MF 

4- Appletl selects the EFdie 

5- Appletl selects the DFtelecom 

6- Appletl selects the MF 

7- Appletl selects the DFtest 

8- Appletl selects the DFtesti 

9- Appletl selects the EFtaa 

10- Appletl tries to select DFadfi 

11- Senca an APDU to trigger Applet2 

12- Applet2 gets the UICC FileView 

13- Applet2 selects the MF 

14- Applet2 selects the EFdie 

15- Applet2 selects the DFtelecom 

16- Applet2 selects the MF 

17- Applet2 selects the DFtest 

18- Applet2 selects the DFtesti 

19- Applet2 selects the EFtaa 

20- Applet2 tries to select DFadfi 


1- Appletl is triggered 

3- No exception is thrown 

4- No exception is thrown 

5- No exception is thrown 

6- No exception is thrown 

7- No exception is thrown 

8- No exception is thrown 

9- No exception is thrown 

1 0- An exception is thrown 

1 1 - Applet2 is triggered 

13- No exception is thrown 

14- No exception is thrown 

15- No exception is thrown 

16- No exception is thrown 

17- No exception is thrown 

18- No exception is thrown 

19- No exception is thrown 

20- An exception is thrown 




3 


Applets can access all files under the ADFl 
using the ADFl file view 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets the ADFl FileView 

3- Appletl selects the ADFl 

4- Appletl selects the DFtelecom 

5- Appletl selects the ADFl 

6- Appletl selects the DFtest 

7- Appletl selects the DFtesti 

8- Appletl selects the EFtaa 

9- Appletl tries to select the MF 

10- Appletl tries to select the EFdie 

11- Appletl tries to select DFadf2 

12- Senca an APDU to trigger Applet2 

13- Applet2 gets the ADFl FileView 

14- Applet2 selects the ADFl 

15- Applet2 selects the DFtelecom 

16- Applet2 selects the ADFl 

17- Applet2 selects the DFtest 

18- Applet2 selects the DFtesti 

19- Applet2 selects the EFtaa 

20- Appletl tries to select the MF 

21- Appletl tries to select the EFdie 

22- Applet2 tries to select DFadf2 


1- Appletl is triggered 

3- No exception is thrown 

4- No exception is thrown 

5- No exception is thrown 

6- No exception is thrown 

7- No exception is thrown 

8- No exception is thrown 

9- An exception is thrown 

1 0- An exception is thrown 
1 1 - An exception is thrown 

1 2- Applet2 is triggered 

14- No exception is thrown 

15- No exception is thrown 

16- No exception is thrown 

17- No exception is thrown 

18- No exception is thrown 

19- No exception is thrown 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 






20- An exception is thrown 








21 - An exception is thrown 








22- An exception is thrown 




4 


FileView object shall be provided as a 
permanent JCRE entry point object 








1- An envelope menu selection is sent to 


1- Appletl is triggered 






trigger Appletl 








2- Appletl gets an UICC FileView in a 








static field 


2- No exception is thrown 






3- Appletl gets an ADFl FileView in a 


3- No exception is thrown 






static field 


4- No exception is thrown 






4- Appletl gets an UICC FileView in a 








field of the toolkit applet 


5- No exception is thrown 






5- Appletl gets an ADFl FileView in a 








field of the toolkit applet 








6- Send an APDU to trigger Applet2 


6- Applet2 is triggered 






7- Applet2 gets an UICC FileView in a 


7- No exception is thrown 






static field 


8- No exception is thrown 






8- Applet2 gets an ADFl FileView in a 


9- No exception is thrown 






static field 








9- Applet2 gets an UICC FileView in a 








field of the toolkit applet 


10- No exception is thrown 






10- Applet2 gets an ADFl FileView in a 








field of the toolkit applet 






5 


Context independence on FileView object 

The following sequence shall be performed 
twice, once with the UICC FileView, then 
once with the ADFl FileView 

1- An envelope menu selection is sent to 








trigger Appletl 


1- Appletl is triggered 






2- Appletl gets 2 UICC {or ADFl) FileView 








and stores them in objects FileViewl and 








FileView2 


2- No exception is thrown 






3- Appletl selects DFtest/EFcaru using the 








FileViewl object 








4- Appletl calls the readRecord { ) method 


3- No exception is thrown 






in the NEXT mode using the FileViewl 








object 


4- The record value is "55 55 55" 






5- Appletl calls the readRecord {) method 








in the NEXT mode using the FileViewl 








object 


5- The record value is "AA AA AA" 






6- Appletl calls the readRecord {) method 








in the NEXT mode using the FileView2 


6- An exception is thrown 






object 








7- Appletl selects EFlaru using the 


7- An exception is thrown 






FileView2 object 








8- Appletl selects DFtest using the 
FileView2 object 


8- No exception is thrown 






9- Appletl selects EFcaru using the 








FileView2 object 


9- No exception is thrown 






10- Appletl calls the readRecord {) method 








in the NEXT mode using the FileView2 


1 0- The record value is "55 55 55" 






object 








The same test sequence is done using the 








non toolkit applet Applet2 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


6 


File Context can be transient or persistent 

The following sequence shall be performed 
twice, once with the UICC FileView, then 
once with the ADFl FileView 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets 2 UICC {or ADFl) 
FileViewand stores one in a transient 
object FileViewl and the other in a 
persistent object FileView2 

3- Appletl selects DFtest/EFcaru using the 
FileViewl object then the FileView2 object 

4- Appletl calls the readRecord { ) method 
in the NEXT mode using the FileViewl 
object then the FileView2 object 

5- Reset the card 

6- An envelope menu selection is sent to 
trigger Appletl 

7- Appletl calls the status {) command 
using the FileViewl 

8- Appletl calls the status {) command 
using the FileView2 

9- Appletl calls the readRecord { ) method 
in the NEXT mode using the FileView2 

10- Appletl calls the readRecord {) method 
in the NEXT mode using the FileViewl 


1- Appletl is triggered 

2- No exception is thrown 

3- No exception is thrown 

4- The record value is "55 55 55" 

6- Appletl is triggered 

7- The current DP is DFtest 

8- The current DF is the root (IVIF 
orADFI) 

9- The record value is "AA AA AA" 

1 0- An exception is thrown 




7 


File Context integrity 

1- An envelope menu selection is sent to 
trigger Appletl 

2- Appletl gets a UICC FileView and 
selects DFtest, with it 

3- Appletl sends a Display Text proactive 
command 

4- Send a fetch command 

5- An envelope call control by NAA is sent 

6- Appletl selects DFtest/DFtesti, using the 
previous UICC FileView, then finalizes 

7- Send terminal response of Display Text 
command 

8- Appletl resumes and calls status {) 
command, using the same UICC FileView 


1- Appletl is triggered 

2- No exception is thrown 

3- SW = 91 XX 

4- Display Text is fetched 

5- Appletl is triggered 

6- No exception is thrown 

7- SW = 90 00 

8- The current DF is DFtesti 





5.5.8.2 File Access 

Test Area Reference: Cre_Ufa_Facc. 
Shall be covered in the API access part. 

5.5.9 Other parts transferred to framework from API 
5.5.9.1 A handler is a temporary JCRE Entry Point object 

Test Area Reference: Cre_Api_Hepo. 

5.5.9.1.1 Conformance requirement 

5.5.9.1 .1 .1 Normal execution 

• CRRNl: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [2]). 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [2]). 
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• CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 Runtime 
Environment (JCRE) Specification [2]). 

• CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.2.1 
Runtime Environment (JCRE) Specification [2]). 



5.5.9.1.1.2 

No requirements. 

5.5.9.1.1.3 

No requirements. 

5.5.9.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.9.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Api_Hepo.java. 
Cre_Api_Hepo_ 1 .j ava. 
Cre_api_hepo . c ap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1,2 


CRRN2 


3,4 


CRRN3 


5,6 


CRRN4 


7,8 



5.5.9.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


EnvelopeHandlerSystem.getTheHandlerO 

store it in a static field of the toolkit 
applet 


Security Exception is thrown 




2 


EnvelopeHandlerSystem.getTheHandlerO 

store it in a field of the toolkit applet 


SecurityException is thrown 




3 


EnvelopeResponseHandlerSystem.getTheHan 
diero 

store it in a static field of the toolkit 
applet 


SecurityException is thrown 




4 


EnvelopeResponseHandlerSystem.getTheHan 
dIerO 

store it in a field of the toolkit applet 


SecurityException is thrown 




5 


ProactiveHandlerSystem.getTheHandlerO 

store it in a static field of the toolkit 
applet 


SecurityException is thrown 




6 


ProactiveHandlerSystem.getTheHandlerO 

store it in a field of the toolkit applet 


SecurityException is thrown 




7 


Build and send a Display Text command to 
be able to get the reference of the 
ProactiveReponseHandler 

ProactiveResponseHandlerSystem.getTheHan 
dIerO 

store it in a static field of the toolkit 
applet 


SecurityException is thrown 


Proactive command is 
fetched and terminal 
response is issued 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


8 


ProactiveResponseHandlerSystem.getTlieHan 
dIerO 

store it in a field of the toolkit applet 


SecurityException is thrown 





5.5.9.2 Transaction 

Test Area Reference: Cre_Api_Tran. 

5.5.9.2.1 Conformance requirement 

5.5.9.2.1.1 Normal execution 

• CRRNl: A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted. 

• CRRN2: A pending toolkit applet transaction is aborted on the termination of the toolkit applet (return from 
the processToolkitO method). 

• CRRN3: At the invocation of the processToolkit() method there shall be no transaction in progress. 



5.5.9.2.1.2 

No requirements. 

5.5.9.2.1.3 

No requirements. 

5.5.9.2.2 

Test Source: 
Test Applet: 

Cap File: 
5.5.9.2.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Api_Tran.j ava. 
Cre_Api_Tran_ 1 .j ava. 
Cre_Api_Tran_2.j ava. 
Cre_api_tran . c ap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


Not testable 
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5.5.9.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Verify that transaction is aborted when a 
proactive command is sent 

1- Appletl is triggered and performed the 
following sequence 

- Initialize a byte field with 0x05 

- Build a display text proactive command 

- beginTransaction { ) 

- Update the byte with 0x02 

- send the proactive command 

3- Applet is resumed 

- Verify that the byte value is 0x05 

- JCSystem.getTransactionDepth { ) 


JCSystem.getTransactionDepthO 
shall return 


2- Proactive command 
fetched and terminal 
response is issued 


2 


Verify that transaction is aborted when a 
proactive command is sent 

1- Applet2 is triggered and send a display 
text proactive command 

Appletl is triggered and performed the 
following sequence 

- Initialize a static byte field with 0x05 

- beginTransaction { ) 

- Update the byte with 0x02 

- Finalize 

3- Applet2 is resumed and 

- Verify that the byte value is 0x05 

- JCSystem.getTransactionDepth { ) 


JCSystem.getTransactionDepthO 
shall return 


2- SW = 91 XX 
Proactive command fetched 
and terminal response is 
issued 



5.5.9.3 Timer Id between Applets 

Test Area Reference: Cre_Api_Tmid. 



5.5.9.3.1 

5.5.9.3.1.1 

No requirements. 

5.5.9.3.1.2 

No requirements. 

5.5.9.3.1.3 



Conformance requirement 
Normal execution 

Parameter errors 

Context errors 



CRRCl: The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with 
INVALID_TIMER_1D reason if the timer is valid but is not allocated to this applet. 



5.5.9.3.2 

Test Source: 
Test Applet: 
Cap File: 



Test area files 

Test_Cre_Api_Tmid.j ava. 
Cre_Api_Tmid_ 1 .j ava. 
Cre_api_tmid . cap . 
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5.5.9.3.3 



5.5.9.3.4 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


During installation : 

First instance allocate a timer and store 
the returned value in a static field. 
Second instance allocate a timer. 

Trigger second instance and try to call 
releaseTimer { ) method with the static 
field value. 


releaseTimerO method call shall 
throw a ToolkitException with 
INVALID TIMER ID reason 





5.5.10 Registration 
5.5.10.1 Event registration 

Test Area Reference: Cre_Reg_Evtr. 



5.5.10.1.1 

5.5.10.1.1.1 

• CRRNl: 

• CRRN2: 

• CRRN3: 

• CRRN4: 

• CRRN5: 

5.5.10.1.1.2 
No requirements. 

5.5.10.1.1.3 
No requirements. 

5.5.10.1.2 

Test Source: 
Test Applet: 

Cap File: 



Conformance requirement 

Normal execution 
A Toolkit Applet can change its registration to toolkit events during its whole life cycle. 
The registration of a Toolkit Applet to an event shall not be affected by its life cycle state. 
The getShareablelnterfaceObjectO has to be called before the applet is triggered the first time. 
The byte parameter of getShareablelnterfaceObjectO method has to be set to '01'. 
The AID parameter of the getShareablelnterfaceObjectO method shall be set to null. 

Parameter errors 
Context errors 
Test area files 

Test_Cre_Reg_Evtr.j ava. 
Cre_Reg_Evtr_ 1 .j ava. 
Cre_Reg_Evtr_2 .j ava. 
Cre_reg_evtr.cap. 
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5.5.10.1.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 but partially tested 


CRRN2 


1, 

and see also 

CRRN9 of Cre_Pcs_Spco 

and 
CRRNSofCre Apt Eccn 


CRRN3 


2 


CRRN4 


2 


CRRN5 


2 



5.5.10.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Tooll<it applet can change its registration 
during its whole life cycle 

1- Install Appletl to let it in the 
INSTALL state 

During its install {) method, Appletl 

registers to 

EVENT EVENT DOWNLOAD USER ACTIVITY and 

EVENT_EVENT_DOWNLOAD_MT_CALL 

2- Make selectable Appletl 

3- An envelope Event Download User 
Activity is sent to trigger Appletl 

4- Appletl registers to 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
deregisters to 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 


3- Appletl is triggered 


2- Set Up Event List 
proactive command is 
fetched with User Activity 
and MT Call events 

4- Set Up Event List 
proactive command is 
fetched with Location Status 
and IVIT Call events 


2 


getShareablelnterfaceObjectQ has to be called 
before the first triggering 

1- Install of Applet2 

Applet2 getShareablelnterfaceObject () 
method increments a counter 

2- Trigger Applet2 


2- Applet2 performs the following 
checks: 

- the counter is incremented 

- byte parameter of 
getShareablelnterfaceObjectQ 
method is set to '01' 

- AID parameter 
getShareablelnterfaceObjectQ 
method is null 





5.5.11 UICC Toolkit Applet 
5.5.11.1 Data and function sharing 

Test Area Reference: Cre Uta Dafs. 



5.5.11.1.1 



Conformance requirement 



The sharing mechanism defined in "Java Card^*^ 2.2.1 Application Programming Interface Specification" ([1]) and 
"Java Card'''^ 2.2.1 Runtime Environment Specification" ([2]) shall be used by the Toolkit Applet(s) to share data and 
function. 
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5.5.11.1.1.1 Normal execution 

• CRRNl:The interface shall extend the javacard.framework.shareable interface. 

• CRRN2: The server Applet shall overwrite the Applet.getShareableInterfaceObject() method. 

• CRRN3: The client Applet shall use the JCSystem.getAppletShareableInterfaceObject() to retrieve a reference 
to the server Applet shareable interface. 

• CRRN4: When the client Applet calls JCSystem.getAppletShareableInterfaceObject() method the 
Applet.getShareablelnterfaceObjectO method of the server Applet is called by the CAT RE. 

5.5.11.1.1.2 Parameter errors 
No requirements. 

5.5.11.1.1.3 Context errors 
No requirements. 

5.5.11.1.2 Test area files 

This clause uses 2 packages: 

uicc.test.catre.cre_uta_dafs.cre_uta_dafs_a 
uicc.test.catre.cre_uta_dafs.cre_uta_dafs_b 
Test Source: Test_Cre_Uta_Dafs.java. 
Test Applet: Cre_Uta_Dafs_A_l.java (server applet). 

Cre_Uta_Dafs_A_2.java (server interface). 

Cre_Uta_Dafs_A_3.java (class). 

Cre_Uta_Dafs_B_l.java (client applet). 
Cap File: Cre_uta_dafs_a.cap. 

Cre_uta_dafs_b . cap . 



5.5.11.1.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRN2 


1 


CRRN3 


1 


CRRN4 


1 
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5.5.11.1.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





1- Install packages PackageA then PackageB 

2- Install AppletAl and AppletBl 






1 


Use of a shareable interface 

1- Send an envelope Menu Selection to 
trigger AppletAl {Menu Id = 01) 

2- AppletAl stores the menu Id 

3- Send an envelope Menu Selection to 
trigger AppletBl 

4- AppletBl uses the shareable interface 
of AppletAl to retrieve the Menu Id that 
was used to trigger AppletAl previously 


1 - AppletAl is triggered 

3- AppletBl is triggered 

4- Menu Id retrieved shall be 01 





5.5.11.2 Package deletion 

Test Area Reference: Cre Uta Pdel. 



5.5.11.2.1 



Conformance requirement 



The Package deletion mechanism defined in "Java Card^"^ 2.2.1 Runtime Environment Specification" ([2]) shall be used 
to delete the content from the UICC. 



5.5.11.2.1.1 



Normal execution 



CRRNl: If the applet/library package is resident in mutable memory, then the Java Card RE shall delete the 
applet/library package. 

CRRN2: Following a successful applet/library package deletion, it shall not be possible to install another 
package which depends on the deleted package. 



5.5.11.2.1.2 
No requirements. 

5.5.11.2.1.3 



Parameter errors 



Context errors 



• CRRCl : The deletion shall fail if a reachable (non-garbage) instance of a class belonging to the package being 
deleted exists on the card. 

• CRRC2: The deletion shall fail if another package on the card depends on this package (as expressed in the 
CAP file's import component). 

5.5.11.2.2 Test area files 

This clause uses 2 packages: 

uicc.test.catre.cre_uta_pdel.cre_uta_pdel_a 

uicc.test.catre.cre_uta_pdel.cre_uta_pdel_b (depends on uicc.test.catre.cre_uta_pdel.cre_uta_pdel_a) 

Test Source: Test_Cre_Uta_Pdel.java. 

Test Applet: Cre_Uta_Pdel_A_l.java. 

Cre_Uta_Pdel_A_2.j ava. 

Cre_Uta_Pdel_A_3.java (server interface) Cre_Uta_Pdel_B_l.java (use class Cre_Uta_Pdel_A_2). 
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Cap File: 



5.5.11.2.3 



Cre_Uta_Pdel_B_2.j ava. 
Cre_uta_pdel_a.cap. 
Cre_uta_pdel_b . cap . 

Test coverage 



CRR number 


Test case number 


CRRN1 


1 to 5 


CRRN2 


3 


CRRC1 


1 


CRRC2 


2 



5.5.11.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





1- Install packages PackageA then PackageB 

2- Install AppletBl 






1 


Tiie package deletion is unsuccessful if a 

reachable instance of a class belonging to the 

package exists on the card 

1- Delete PackageB 

2- Install AppletB2 

3- Delete AppletBl and AppletB2 




1 - SW shall be different 

from 90 00 

2- RAPDU = 00 90 00 


2 


The package deletion is unsuccessful If 

another package on the card depends on this 

package 

1- Delete PackageA 

2- Install AppletAl 

3- Delete AppletAl 




1 - SW shall be different 

from 90 

02- RAPDU = 00 90 00 


3 


The installation of a package which depends 
on a deleted package shall fail 

1- Delete PackageB 

2- Delete PackageA 

3- Install PackageB 




1-SW = 90 00 

2- SW = 90 00 

3- SW shall be different 
from 90 00 


4 


Once a package is deleted, it shall not be 
possible to install an applet from this package 

1- Install AppletAl 

2- Install AppletB2 




1-SW = SW shall be 
different from 90 00 

2- SW = SW shall be 
different from 90 00 


5 


This test checks that it is possible to re-install 
the same package 

1- Install PackageA 

2- Install AppletAl 




2- RAPDU = 00 90 00 



5.5.11.3 Applet deletion 

Test Area Reference: Cre Uta Adel. 
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5.5.11.3.1 



Conformance requirement 



The Applet deletion mechanism defined in "Java Card''^ 2.2.1 Runtime Environment Specification" ([2]) shall be used 
to delete the content from the UICC. 

5.5.11.3.1.1 Normal execution 

• CRRNl: Following a successful applet instance deletion, the Java Card RE shall delete the applet instance. 

• CRRN2: Following an unsuccessful applet instance deletion, the applet instance shall be selectable, and all 
objects owned by the applet shall remain unchanged. 

• CRRN3: Following a successful applet instance deletion, it shall not be possible to select that applet, and no 
object owned by the applet can be accessed by any applet currently on the card or by a new applet created in 
the future. 



5.5.11.3.1.2 
No requirements. 

5.5.11.3.1.3 



Parameter errors 



Context errors 



• CRRCl: The deletion shall fail if any object owned by the applet instance is referenced from an object owned 
by another applet instance on the card. 

• CRRC2: The deletion shall fail if any object owned by the applet instance is referenced from a static field on 
any package on the card. 

• CRRC3: The deletion shall fail if an applet instance, belonging to the context of the applet instance being 
deleted, is active (selected) on the card. 

5.5.11.3.2 Test area files 

This clause uses 2 packages: 

uicc.test.catre.cre_uta_adel.cre_uta_adel_a 
uicc.test.catre.cre_uta_adel.cre_uta_adel_b 
Test Source: Test_Cre_Uta_Adel.java. 
Test Applet: Cre_Uta_Adel_A_l .j ava. 

Cre_Uta_Adel_A_2.j ava. 

Cre_Uta_Adel_A_3 .j ava. 

Cre_Uta_Adel_B_ 1 .j ava. 

Cre_Uta_Adel_B_2. Java. 
Cap File: Cre_uta_adel_a.cap. 

Cre_uta_adel_b .cap . 



5.5.11.3.3 



Test coverage 



CRR number 


Test case number 


CRRN1 


3,4 


CRRN2 


1,2,3 


CRRN3 


4,5 


CRRC1 


1 


CRRC2 


2 


CRRC3 


3 
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5.5.11.2.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 





1- Install packages PackageA then PackageB 

2- Install AppletAl, AppletA2, AppletBl 
and AppletB2 






1 


The deletion shall fail if any object owned by 

the applet instance is referenced from an 

object owned by another applet instance on 

the card 








1- Send an envelope Menu Selection to 
trigger AppletAl 


1- AppletAl is triggered 






2- AppletAl store the menu Id 








3- Send an envelope Menu Selection to 


3- AppletA2 is triggered 






trigger AppletA2 








4- AppletA2 gets a reference to the 








shareable interface to retrieve the menu 








Id used to trigger AppletAl 








5- Delete AppletAl 




5- SW shall be different 
from 90 00 




6- Send an envelope Menu Selection to 
trigger AppletAl 


6- AppletAl is triggered 






7- Send an envelope Menu Selection to 
trigger AppletA2 


7- AppletA2 is triggered 


7- SW = 90 00 




8- AppletA2 frees the reference to the 








shareable interface 








9- Delete AppletAl 








10- Install AppletAl 




9- SW = 90 00 




11- Send an envelope Menu Selection to 


1 1 - AppletAl is triggered 


10- RAPDU = 00 90 00 




trigger AppletAl 








12- AppletAl store the menu Id 








13- Send an envelope Menu Selection to 
trigger AppletB2 


1 3- AppletB2 is triggered 






14- AppletB2 gets a reference to the 








shareable interface to retrieve the menu 








Id used to trigger AppletAl 
15- Delete AppletAl 




1 5- SW shall be different 
from 90 00 




16- Send an envelope Menu Selection to 
trigger AppletAl 


16- AppletAl is triggered 






17- Send an envelope Menu Selection to 
trigger AppletB2 


1 7- AppletB2 is triggered 


1 7- SW = 90 00 




18- AppletB2 frees reference to the 








shareable interface 








19- Delete AppletAl 








20- Install AppletAl 




19-SW = 90 00 

20- RAPDU = 00 90 00 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


2 


The deletion shall failed if any object owned by 

the applet instance is referenced from a static 

field on any package on the card 








1- Send an envelope Menu Selection to 
trigger AppletAl 


1- AppletAl is triggered 






2- AppletAl store the menu Id 

3- Send an envelope Menu Selection to 
trigger AppletA2 








4- AppletA2 gets a reference to the 
shareable interface and stores it in a 
static field of PackageA, then retrieves 
the menu Id used to trigger AppletAl 

5- Delete AppletA2 


3- AppletA2 is triggered 


5- SW = 90 00 




6- Delete AppletAl 

7- Send an envelope Menu Selection to 
trigger AppletAl 


7- AppletAl is triggered 


6- SW shall be different 
from 90 00 




8- AppletAl frees the reference to the 
shareable interface 








9- Delete AppletAl 

10- Install AppletAl 




9- SW = 90 00 




11- Send an envelope Menu Selection to 
trigger AppletAl 


1 1 - AppletAl is triggered 


10-RAPDU = 00 90 00 




12- AppletAl store the menu Id 

13- Send an envelope Menu Selection to 
trigger AppletB2 


1 3- AppletB2 is triggered 






14- AppletB2 gets a reference to the 
shareable interface and stores it in a 
static field of Packages, then retrieves 
the menu Id used to trigger AppletAl 

15- Delete AppletB2 




1 5- SW = 90 00 




16- Delete AppletAl 

17- Send an envelope Menu Selection to 
trigger AppletAl 


1 7- AppletAl is triggered 


1 6- SW shall be different 
from 90 00 




18- Send an envelope Menu Selection to 
trigger AppletBl 


18- AppletBl is triggered 






19- AppletBl then frees the reference to 
the shareable interface 








20- Delete AppletAl 








21- Install AppletAl 




20- SW = 90 00 

21- RAPDU = 00 90 00 


3 


Deletion of an active applet instance 








1- Delete AppletBl 




1 - SW = 90 00 




2- Install AppletBl 




2- RAPDU = 00 90 00 




3- Open another channel and select 
AppletBl the new open channel 

4- Delete AppletBl on channel 




3- RAPDU = <applet 
selected data> 90 00 




5- Select AppletBl on Channel 




4- SW shall be different 
from 90 00 




6- Reset 




5- RAPDU = <applet 
selected data> 90 00 
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Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


4 


Selection of a deleted applet instance 

1- Delete AppletBl 

2- Select AppletBl on Channel 

3- Install AppletBl 




1 - SW = 90 00 

2- SW shall be different 
from 90 00 

3- RAPDU = 00 90 00 


5 


Object owned by a deleted applet can't be 
accessed by other applets 

1- Delete AppletAl 

2- Send an envelope Menu Selection to 
trigger AppletBl 

3- AppletBl gets a reference to the 
shareable interface to retrieve the menu 
Id used to trigger AppletAl 


2- AppletBl is triggered 

3- An exception is tlirown 


1-SW = 90 00 



5.5.11.4 Object deletion 

Test Area Reference: Cre_Uta_Odel. 

5.5.1 1 .4.1 Conformance requirement 

5.5.11.4.1.1 Normal execution 

• CRRNl: If an object deletion mechanism is supported then the one defined in "Java Card^*^ 2.2.1 Application 
Programming Interface Specification" ([1]) shall be used. 



5.5.11.4.1.2 
No requirements. 

5.5.11.4.1.3 
No requirements. 

5.5.11.4.2 
Test Script: 
Test Applet: 
Cap File: 

5.5.11.4.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Uta_Odel .j ava 
Cre_Uta_Odel_ 1 .j ava 
Cre_uta_odel.cap 

Test coverage 



CRR number 


Test case number 


CRRNl 


1 



5.5.11.4.4 



Test procedure 



Id 


Description 


API/CAT RE Expectation 


APDU Expectation 


1 


Object deletion 

1- Applet calls 

JCSystem. isObjectDeletionSupported { ) 


2- Returns TRUE 
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5.5.12 Proactive Command Handling 
5.5.12.1 General behaviour 

Test Area Reference: Cre Pch Genb. 



5.5.12.1.1 



5.5.12.1.1.1 



Conformance requirement 



Normal execution 



• CRRNl: On the call to the send() method, the CAT Runtime Environment shall handle the transmission of the 
proactive command to the terminal, and the reception of the response. 

• CRRN2: The CAT Runtime Environment shall resume the Toolkit Applet execution on the return from the 
send() method. 



5.5.12.1.1.2 


Parameter errors 


No requirements. 




5.5.12.1.1.3 


Context errors 


No requirements. 




5.5.12.1.2 


Test area files 


None. 




5.5.12.1.3 


Test coverage 



CRR number 


Test case number 


CRRN1 


See test case 2 of 
Cre Hin Prhd 



5.5.12.1.4 

None. 



Test procedure 



5.5.13 CAT Runtime Environment behaviour 
5.5.13.1 Context 

Test Area Reference: Cre_Cat_Ctxt. 

5.5.1 3.1 .1 Conformance requirement 

5.5.13.1.1.1 Normal execution 

• CRRN 1 : At the invocation of the processToolkit() method the context as defined in Java Card shall be set to 
the context of the Toolkit Applet. The previous context (context of the caller) shall be the context of the CAT 
Runtime Environment. 

• CRRN2: During the execution there might be other context switches, but at the return of the send() method the 
toolkit applet context is restored. 
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5.5.13.1.1.2 
No requirements. 

5.5.13.1.1.3 
No requirements. 

5.5.13.1.2 

Test Source: 
Test Applet: 
Cap File: 

5.5.13.1.3 



Parameter errors 
Context errors 
Test area files 

Test_Cre_Cat_Ctxt.j ava. 
Cre_Cat_Ctxt_l .Java. 
Cre_cat_ctxt.cap. 

Test coverage 



CRR number 


Test case number 


CRRN1 


Not Testable 


CRRN2 


see Cre Hin Enhd 



5.5.13.1.4 

Not applicable. 



Test procedure 



5.5.14 UICC and ADF File System Administration API 
5.5.14.1 AdminFile View 

Test Area Reference: Cre_Fsa_View 

5.5.14.1.1 Conformance requirement 

5.5.14.1.1.1 Normal execution 

• CRRNl: AdminFileView objects follow the behaviour of FileView objects and inherit FileView functionality. 

• CRRN2: An AdminFileView object can be retrieved by invoking one of the getAdminFileView( ) methods 
defined in the AdminFileViewBuilder class. 

• CRRN3: Each AdminFileView shall be given the access control privileges associated with the UICC or the 
corresponding ADF for the Applet. 

• CRRN4: The access control privileges are checked against the access rules defined in TS 102 221 [5] each 
time a method of the AdminFileView object is invoked. 



5.5.14.1.1.2 
No requirements. 

5.5.14.1.1.3 
No requirements. 

5.5.14.1.2 
None. 



Parameter errors 



Context errors 



Test area files 
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5.5.14.1.3 



5.5.14.1.4 
None. 



Test coverage 



CRR number 


Test case number 


CRRN1 


See API 4 Afv xxxx 


CRRN2 


See API 4 Afb xxxx 


CRRN3 


See Cre Tin Acdo 


CRRN4 


See Cre Tin Acdo 



Test procedure 



5.5.14.2 AdminFile Access 

Test Area Reference: Cre_Fsa_Aacc. 
See API access. administration part. 
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Annex A (normative): 

Class and methods acronyms 

A.1 uicc.access package 



Interface / Class Name 


Acronyms 


FileView 


Fvw 


UlCCConstants 


Uct 


UlCCSystem 


Usy 


UICCException 


Uex 



A.1 .1 FileView methods 



Method Name 


Acronyms 


public void activateFile { ) 


Actf 


public void deactivateFile { ) 


Dacf 


public short increase {byte [] incr, short incrOffset, 
short incrLength, byte[] resp, short respOffset) 


Incr 


public short readBinary {short fileOffset, 

byte [] resp, short respOffset, short respLength) 


Redb 


public short readRecord {short recNumber, byte mode, 
short recOffset, byte [] resp, short respOffset, 
short respLength) 


Redr 


public short searchRecord {byte mode, 

short recordNum, short searchlndication, 

byte[] patt, short pattOffset, short pattLength, 

short [] response, short respOffset, 

short respLength) 


Sear 


public void select {byte sfi) 


SIctb 


public void select {short fid) 


SIcts 


public short select {short fid, byte [] fcp, 
short fcpOffset, short fcpLength) 


Slct_Bss 


public short status {byte [] fcp, short fcpOffset, 
short fcpLength) 


Stat 


public void updateBinary {short fileOffset, 
byte[] data, short dataOffset, short dataLength) 


Updb 


public void updateRecord {short recNumber, byte mode, 
short recOffset, byte[] data, short dataOffset, 
short dataLength) 


Updr 



A.1. 2 UlCCConstants 



Method Name 


Acronyms 


Constants 


Cnst 



A.1 .3 UlCCSystem methods 



Method Name 


Acronyms 


public static FileView 

getTheFileView{ javacard. framework. AID aid, 

byte event) 


Getfob 


public static FileView getTheFileView {byte [] buffer, 
short bOffset, byte bLength, byte event) 


Getf_Bsbb 


public static FileView getTheUICCView {byte event) 


Getfb 
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A. 1.4 UlCCException methods 



Method Name 


Acronyms 


public UlCCException {short reason) 


Coor 


public static void throwit {short reason) 


Thit 


Constants 


Cons 



A.2 uicc.toolkit package 



BERTLVEditHandler 


Bte 


BERTLWiewHandler 


Btv 


EditHandler 


Edh 


EnvelopeHandler 


Enh 


EnvelopeResponseHandler 


Erh 


ProactiveHandler 


Pah 


ProactiveResponseHandler 


Prh 


ToolkitConstants 


Tkc 


Toolkit Inter face 


Tki 


ToolkitRegistry 


Tkr 


ViewHandler 


Vwh 


EnvelopeHandlerSystem 


Ehs 


EnvelopeResponseHandlerSystem 


Ers 


ProactiveHandlerSystem 


Phs 


ProactiveResponseHandlerSystem 


Prs 


TerminalProf ile 


Tep 


ToolkitRegistrySystem 


Trs 


Toolkit Except ion 


Tke 



A.2.1 BERTLVEditHandler methods 



Method Name 


Acronyms 


public void setTag{byte bBERTag) 


Sttg 






Inherited method name: EditHandler 




void appendArray {byte [] buffer, short offset, short 
length) 


Apda 


void appendTLV{byte tag, byte value) 


Aptibb 


void appendTLV{byte tag, byte[] value, short 
valueOffset, short valueLength) 


Aptlb_Bss 


void appendTLV{byte tag, byte[] valuel, short 
valuelOf f set , short valuelLength, byte[] value2, 
short value20f f set , short value2Length) 


Aptlb_Bss_Bss 


void appendTLV{byte tag, byte valuel, byte value2) 


Aptlbbb 


void appendTLV{byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


Aptlbb_Bss 


void appendTLV{byte tag, byte valuel, short value2) 


Aptlbbs 


void appendTLV{byte tag, short value) 


Aptlbs 


void appendTLV{byte tag, short valuel, short value2) 


Aptlbss 


void clear {) 


Cler 






Inherited method name: ViewHandler 




byte compareValue {short valueOffset, byte [] 
compareBuf f er, short compareOf f set , short 
compareLength) 


Cprv 


short copy{byte[] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue {short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f indAndCompareValue {byte tag, byte [] 
compareBuf fer, short compareOf f set) 


Facrb_Bs 
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Method Name 


Acronyms 


byte f indAndCompareValue {byte tag, byte occurence, 
short valueOffset, byte[] compareBuf f er, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue {byte tag, byte [] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f indAndCopyValue {byte tag, byte occurence, 
short valueOffset, byte [] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte f indTLV{byte tag, byte occurrence) 


Find 


short getCapacity { ) 


Gcap 


short getLength { ) 


Glen 


byte getValueByte {short valueOffset) 


Gvby 


short getValueLength { ) 


Gvie 


short getValueShort {short valueOffset) 


Gvsh 






Inherited method name: BERTLVViewHandler 




short getSize{) 


Gtsz 


byte getTag { ) 


Gttg 



A.2.2 BERTLVViewHandler methods 

Tests are done in inheriting interfaces BERTLVEditHandler and envelopeHandler. 

A.2.3 EditHandler methods 

Tests are done in inheriting interfaces EnvelopeResponseHandler and ProactiveHandler. 

A.2.4 EnvelopeHandler methods 



Method Name 


Acronyms 


Byte getChannelldentif ier { ) 


Gcid 


Short getChannelStatus {byte channelldentif ier) 


Gcst 


Byte getltemldentif ier { ) 


Giid 






Inherited method name: BERTLVViewHandler 




short getSize{) 


Gtsz 


byte getTag {) 


Gttg 






Inherited method name: ViewHandler 




byte compareValue {short valueOffset, byte [] 
compareBuf fer, short compareOf f set , short 
compareLength) 


Gprv 


short copy{byte[] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue {short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Gpyv 


byte f indAndCompareValue {byte tag, byte [] 
compareBuf fer, short compareOf f set) 


Facrb_Bs 


byte f indAndCompareValue {byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue {byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f indAndCopyValue {byte tag, byte occurence, 
short valueOffset, byte [] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV{byte tag, byte occurrence) 


Find 


short getCapacity { ) 


Gcap 


short getLength { ) 


Glen 


byte getValueByte {short valueOffset) 


Gvby 


short getValueLength { ) 


GvIe 


short getValueShort {short valueOffset) 


Gvsh 
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A.2.5 EnvelopeResponseHandler methods 



Method Name 


Acronyms 


void post {boolean value) 


Post 


void postAsBERTLV {boolean value, byte tag) 


Pabt 






Inherited method name: EditHandler 




void appendArray {byte [] buffer, short offset, short 
length) 


Apda 


void appendTLV{byte tag, byte value) 


Aptibb 


void appendTLV{byte tag, byte[] value, short 
valueOffset, short valueLength) 


Aptlb_Bss 


void appendTLV{byte tag, byte [] valuel, short 
valuelOf f set , short valuelLength, byte [] value2, 
short value20f f set , short value2Length) 


Aptlb_Bss_Bss 


void appendTLV{byte tag, byte valuel, byte value2) 


Aptlbbb 


void appendTLV{byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


Aptlbb_Bss 


void appendTLV{byte tag, byte valuel, short value2) 


Aptlbbs 


void appendTLV{byte tag, short value) 


Aptlbs 


void appendTLV{byte tag, short valuel, short value2) 


Aptlbss 


void clear {) 


Cler 






Inherited method name: ViewHandler 




byte compareValue {short valueOffset, byte[] 
compareBuf f er, short compareOf f set , short 
compareLength) 


Cprv 


short copy{byte[] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue {short valueOffset, byte [] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f indAndCompareValue {byte tag, byte [] 
compareBuf fer, short compareOf f set) 


FaGrb_Bs 


byte f indAndCompareValue {byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue {byte tag, byte[] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f indAndCopyValue {byte tag, byte occurence, 
short valueOffset, byte [] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV{byte tag, byte occurrence) 


Find 


short getCapacity { ) 


Gcap 


short getLength{) 


Glen 


byte getValueByte {short valueOffset) 


Gvby 


short getValueLength { ) 


Gvie 


short getValueShort {short valueOffset) 


Gvsh 



A.2.6 ProactiveHandler methods 



Method Name 


Acronyms 


void init {byte type, byte qualifier, byte dstDevice) 


Init 


void initCloseChannel {byte bChannelld) 


lech 


void initDisplayText {byte qualifier, byte dcs, 
byte[] buffer, short offset, short length) 


Indt 


void initGetlnkey {byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


Ingk 


void initGetlnput {byte qualifier, byte dcs, byte [] 
buffer, short offset, short length, short 
minRespLength, short maxRespLength) 


Ingi 


void initMoreTime { ) 


Inmt 


byte send { ) 


Send 






Inherited method name: EditHandler 




void appendArray {byte [] buffer, short offset, short 
length) 


Apda 


void appendTLV{byte tag, byte value) 


Aptibb 


void appendTLV{byte tag, byte [] value, short 


Aptlb_Bss 
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Method Name 


Acronyms 


valueOffset, short valueLength) 




void appendTLV{byte tag, byte [] valuel, short 
valuelOf f set , short valuelLength, byte[] value2, 
short value20f f set , short value2Length) 


Aptlb_Bss_Bss 


void appendTLV{byte tag, byte valuel, byte value2) 


Aptlbbb 


void appendTLV{byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


Aptlbb_Bss 


void appendTLV{byte tag, byte valuel, short value2) 


Aptlbbs 


void appendTLV{byte tag, short value) 


Aptlbs 


void appendTLV{byte tag, short valuel, short value2) 


Aptlbss 


void clear {) 


Cler 






Inherited method name: ViewHandler 




byte compareValue {short valueOffset, byte [] 
compareBuf f er, short compareOf f set , short 
compareLength) 


Cprv 


short copy{byte[] dstBuffer, short dstOffset, short 
dstLength) 


Copy 


short copyValue {short valueOffset, byte [] dstBuffer, 
short dstOffset, short dstLength) 


Cpyv 


byte f indAndCompareValue {byte tag, byte [] 
compareBuf fer, short compareOf f set) 


Facrb_Bs 


byte f indAndCompareValue {byte tag, byte occurence, 
short valueOffset, byte[] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue {byte tag, byte [] dstBuffer, 
short dstOffset) 


Facyb_Bs 


short f indAndCopyValue {byte tag, byte occurence, 
short valueOffset, byte [] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV{byte tag, byte occurrence) 


Find 


short getCapacity { ) 


Gcap 


short getLength{) 


Glen 


byte getValueByte {short valueOffset) 


Gvby 


short getValueLength { ) 


Gvie 


short getValueShort {short valueOffset) 


Gvsh 



A.2.7 ProactiveResponseHandler methods 



Method Name 


Acronyms 


short copyAdditionallnformation {byte [] dstBuffer, 
short dstOffset, short dstLength) 


Gpai 


short copyChannelData {byte [] dstBuffer, short 
dstOffset, short dstLength) 


Gchd 


short copyTextString {byte [] dstBuffer, short 
dstOffset) 


Gpts 


short getAdditionalInf ormationLength { ) 


Gtil 


byte getChannelldentif ier { ) 


Gcid 


short getChannelStatus {byte channelldentif ier) 


Gcst 


byte getGeneralResult { ) 


Gtgr 


byte getltemldentif ier { ) 


Gtii 


byte getTextStringCodingScheme { ) 


Gtcs 


short getTextStringLength { ) 


GttI 






Inherited method name: ViewHandler 




byte compareValue {short valueOffset, byte[] 
compareBuf fer, short compareOf f set , short 
compareLength) 


Gprv 


short copy{byte[] dstBuffer, short dstOffset, short 
dstLength) 


Gopy 


short copyValue {short valueOffset, byte[] dstBuffer, 
short dstOffset, short dstLength) 


Gpyv 


byte f indAndCompareValue {byte tag, byte [] 
compareBuf fer, short compareOf f set) 


Facrb_Bs 


byte f indAndCompareValue {byte tag, byte occurence, 
short valueOffset, byte [] compareBuf fer, short 
compareOf f set , short compareLength) 


Facrbbs_Bss 


short f indAndCopyValue {byte tag, byte [] dstBuffer, 


Facyb Bs 
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Method Name 


Acronyms 


short dstOffset) 




short f indAndCopyValue {byte tag, byte occurence, 
short valueOffset, byte[] dstBuffer, short 
dstOffset, short dstLength) 


Facybbs_Bss 


byte findTLV{byte tag, byte occurrence) 


Find 


short getCapacity { ) 


Gcap 


short getLengthO 


Glen 


byte getValueByte {short valueOffset) 


Gvbys 


short getValueLength { ) 


Gvie 


short getValueShort {short valueOffset) 


Gvsh 



A.2.8 ToolkitConstants methods 



Method Name 


Acronyms 


Constants 


Cons 



A.2.9 Toolkitlnterface methods 



Method Name 


Acronyms 


void processToolkit {short event) 


Prtk 



A.2.10 ToolkitRegistry methods 



Method Name 


Acronyms 


byte allocateServiceldentif ier { ) 


Asid 


byte allocateTimer { ) 


Atim 


void changeMenuEntry {byte id, byte[] menuEntry, 
short offset, short length, byte nextAction, boolean 
helpSupported, byte iconQualif ier, short 
iconldentif ier) 


Gmet 


void clearEvent {short event) 


Cevt 


public void deregisterFileEvent {short event, byte [] 
baFileList, short sOffsetl, short sLengthl, byte [] 
baADFAid, short sOffset2, byte bLength2) 


Drfes_Bss_Bss 


public void deregisterFileEvent {short event, 
FileView aFileView) 


Drfeso 


void disableMenuEntry {byte id) 


Dmet 


void enableMenuEntry {byte id) 


Emet 


short getPollInterval { ) 


Gpol 


byte initMenuEntry {byte [] menuEntry, short offset, 
short length, byte nextAction, boolean 
helpSupported, byte iconQualif ier, short 
iconldentif ier) 


Imet 


boolean isEventSet {short event) 


levs 


public void registerFileEvent {short event, byte [] 
baFileList, short sOffsetl, short sLengthl, byte [] 
baADFAid, short sOffset2, byte bLength2) 


Rgfes_Bss_Bsb 


public void registerFileEvent {short event, FileView 
aFileView) 


Rgfeso 


void releaseServiceldentif ier {byte 
serviceldentif ier) 


Rsid 


void releaseTimer {byte timerldentif ier) 


Rtim 


void requestPollInterval {short duration) 


Rpol 


void setEvent {short event) 


Sevt 


void setEventList {short [] eventList, short offset, 
short length) 


SevI 


public void setMenuEntryTextAttribute {byte id, 
byte [] textAttribute, short offset, short length) 


Smta 
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A.2.1 1 ViewHandler methods 

Tests are done in inheriting interfaces EnvelopeHandler, EnvelopeResponseHandler, ProactiveHandler and 
ProactiveResponseHandler. 

A.2.1 2 EnvelopeHandlerSystem methods 



Method Name 


Acronyms 


public static EnvelopeHandler getTheHandler { ) 


Gthd 



A.2.1 3 EnvelopeResponseHandlerSystem methods 



Method Name 


Acronyms 


public static EnvelopeResponseHandler getTheHandler { ) 


Gthd 



A.2.1 4 ProactiveHandlerSystem methods 



Method Name 


Acronyms 


public static ProactiveHandler getTheHandler { ) 


Gthd 



A.2.1 5 ProactiveResponseHandlerSystem methods 



Method Name 


Acronyms 


public static ProactiveResponseHandler getTheHandler { ) 


Gthd 



A.2.1 6 TerminalProfile methods 



Method Name 


Acronyms 


static boolean check {byte index) 


Checb 


static boolean check {byte [] mask, short offset, 
short length) 


Chec_Bss 


static boolean check {short index) 


Checs 


static short copy {short startOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 


Copy 


static short getValue {short idx) 


Gvals 


static short getValue {short indexMSB, short 
indexLSB) 


Gvaiss 



A.2.1 7 ToolkitRegistrySystem methods 



Method Name 


Acronyms 


public static ToolkitRegistry getEntry{) 


Gety 



A.2.1 8 ToolkitException methods 



Method Name 


Acronyms 


Constants 


Cons 


public ToolkitException {short reason) 


Coor 


public static void throwit {short reason) 


Thit 
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A.3 uicc.system package 



HandlerBuilder 


Hbd 


UlCCPlatform 


Upt 



A.3.1 BERTLVEditHandler methods 



Method Name 


Acronyms 


static ViewHandler buildTLVHandler {byte type, short 
capacity) 


Bthdbs 


static ViewHandler buildTLVHandler {byte type, short 
capacity, byte[] buffer, short bOffset, short 
bLength) 


Bthdbs_Bss 



A.3.2 UlCCPlatform methods 



Method Name 


Acronyms 


public static byte[] getTheVolatileByteArray { ) 


Gvba 



A.4 uicc.access.fileadministration package 



Interface / Class Name 


Acronyms 


AdminFileView 


Afv 


AdminFileViewBuilder 


Afb 


AdminException 


Aex 



A.4.1 AdminFileView methods 



Method Name 


Acronyms 


public void createFile {ViewHandler ViewHandler) 


Crtf 


public void deleteFile {short fid) 


DItf 


public void resizeFile {ViewHandler ViewHandler) 


Rszf 






Inherited method name: FileView 




public void activateFile { ) 


Actf 


public void deactivateFile { ) 


Dacf 


public short increase {byte [] incr, short incrOffset, 
short incrLength, byte[] resp, short respOffset) 


Incr 


public short readBinary {short fileOffset, 
byte[] resp, short respOffset, short respLength) 


Redb 


public short readRecord {short recNumber, byte mode, 
short recOffset, byte[] resp, short respOffset, 
short respLength) 


Redr 


public short searchRecord {byte mode, 

short recordNum, short searchlndication, 

byte[] patt, short pattOffset, short pattLength, 

short [] response, short respOffset, 

short respLength) 


Sear 


public void select {byte sfi) 


SIctb 


public void select {short fid) 


SIcts 


public short select {short fid, byte [] fcp, 
short fcpOffset, short fcpLength) 


Slct_Bss 


public short status {byte [] fcp, short fcpOffset, 
short fcpLength) 


Stat 


public void updateBinary {short fileOffset, 
byte[] data, short dataOffset, short dataLength) 


Updb 


public void updateRecord {short recNumber, byte mode, 
short recOffset, byte [] data, short dataOffset, 
short dataLength) 


Updr 
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A.4.2 AdminFileViewBuilder methods 



Method Name 


Acronyms 


public static AdminFileView 
getTheUICCAdminFileView{byte bType) 


Gtafb 


public static AdminFileView 

getTheAdminFileView {byte [] buffer, short bOffset, 

byte bLength, byte bType) 


Gtaf_Bsbb 


public static AdminFileView 

getTheAdminFileView {javacard. framework. AID aid, byte 

bType) 


Gtafob 



A.4.3 AdminException methods 



Method Name 


Acronyms 


Constants 


Cons 


public AdminException {short reason) 


Goor 


public static void throwit {short reason) 


Thit 



A.5 Acronyms for CAT Runtime Environment tests 



Minimum liandler availability 


Mha 


Handler integrity 


Hin 


Applet triggering 


Apt 


Proactive command sending by the CAT Runtime Environment 


Pes 


Exception handling 


Exh 


Envelope response posting 


Erp 


Toolkit installation 


Tin 


Dice file access 


Ufa 


Other parts transferred from API to GAT RE 


Api 


Registration 


Reg 


UIGG toolkit applet 


Ufa 


Proactive command handling 


Pch 


GAT Runtime Environment behaviour 


Gat 



A.5.1 Minimum handler availability 



Method Name 


Acronyms 


ProactiveHandler 


Pahd 


ProactiveResponseHandler 


Prhd 


EnvelopeHandler 


Enhd 


EnvelopeResponseHandler 


Erhd 



A. 5. 2 Handler integrity 



Method Name 


Acronyms 


ProactiveHandler 


Pahd 


ProactiveResponseHandler 


Prhd 


EnvelopeHandler 


Enhd 


EnvelopeResponseHandler 


Erhd 
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A. 5. 3 Applet triggering 



Method Name 


Acronyms 


General behaviour 


Genb 


EVENT PROFILE DOWNLOAD 


Epdw 


EVENT MENU SELECTION 


Emse 


EVENT MENU SELECTION HELP REQUEST 


Emsh 


EVENT CALL CONTROL BY NAA 


Eccn 


EVENT TIMER EXPIRATION 


Etex 


EVENT EVENT DOWNLOAD MT CALL 


Edmc 


EVENT EVENT DOWNLOAD CALL CONNECTED 


Edcc 


EVENT EVENT DOWNLOAD CALL DISCONNECTED 


Edcd 


EVENT EVENT DOWNLOAD LOCATION STATUS 


Edis 


EVENT EVENT DOWNLOAD USER ACTIVITY 


Edua 


EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 


Edis 


EVENT EVENT DOWNLOAD CARD READER STATUS 


Edcr 


EVENT UNRECOGNIZED ENVELOPE 


Euev 


EVENT STATUS COMMAND 


Estc 


EVENT EVENT DOWNLOAD LANGUAGE SELECTION 


Edig 


EVENT EVENT DOWNLOAD BROWSER TERMINATION 


Edbt 


EVENT FIRST COMMAND AFTER ATR 


Efca 


EVENT EVENT DOWNLOAD DATA AVAILABLE 


Edda 


EVENT EVENT DOWNLOAD CHANNEL STATUS 


Edcs 


EVENT EVENT DOWNLOAD ACCESS TECHNOLOGY CHANGE 


Edat 


EVENT EVENT DOWNLOAD DISPLAY PARAMETER CHANGED 


Eddp 


EVENT EVENT DOWNLOAD LOCAL CONNECTION 


Edic 


EVENT APPLICATION DESELECT 


Fade 


EVENT PROACTIVE HANDLER AVAILABLE 


Epha 


EVENT EVENT DOWNLOAD NETWORK SEARCH MODE CHANGE 


Edns 


EVENT EVENT DOWNLOAD BROWSING STATUS 


Edbs 



A.5.4 



Proactive command sending by the CAT Runtime 
Environment 



Method Name 


Acronyms 


System Proactive Commands 


Spec 


Interaction with UICC commands 


igco 


Proactive Command Control 


Pcco 



A. 5. 5 Exception handling 



Method Name 


Acronyms 


General Behaviour 


Genb 


Interaction with Multiple Triggering 


Imtg 



A. 5. 6 Envelope response posting 



Method Name 


Acronyms 


EVENT CALL CONTROL BY NAA 


Eccn 


EVENT UNRECOGNIZED ENVELOPE 


Euen 


General Behaviour 


Genb 
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A. 5. 7 Toolkit installation 



Method Name 


Acronyms 


General Behaviour 


Genb 


Timers Allocation 


Tmal 


Item Identifier 


Itid 


Item Position 


Itpo 


IVIaximum Text Length for a menu entry 


Mime 


IVIaximum number of menu entries 


Nbme 


Access Domain 


Acdo 


Priority Level 


Priv 


Channel Allocation 


Ghal 


IVIinimum Security Level 


Mslv 


TAR Value(s) of the Toolkit Application instance 


Tarv 


Services Allocation 


Sval 



A.5.8 UICC file access 



Method Name 


Acronyms 


File View 


View 


File Access 


Face 



A.5.9 Other parts transferred from API to CAT RE 



Method Name 


Acronyms 


A handler is a temporary JCRE Entry Point object 


Hepo 


Transaction 


Tran 


Timer Id between Applets 


Tmid 



A. 5. 10 Registration 



Method Name 


Acronyms 


Event registration 


Evtr 



A.5.11 UICC toolkit applet 



Method Name 


Acronyms 


Data and function sharing 


Dafs 


Package deletion 


Pdel 


Applet deletion 


Adel 


Object deletion 


Odel 



A.5.12 Proactive command handling 



Method Name 


Acronyms 


General behaviour 


Genb 
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A.5.13 CAT Runtime Environment behaviour 



Method Name 


Acronyms 


Context 


Ctxt 
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Annex B (normative): 
Global prepersonalization 



This annex defines the file systems used to pass the test suite. It is composed of the UICC File System Server 
(including MF and all DFs and EFs that are located under the MF) and of two Application Dedicated Files System 
Servers, ADFl and ADF2. 

ADFl and ADF2 shall use the following AIDs (as defined in section "4.7 AID Coding"): 

• ADFl : AO 00 00 00 09 00 05 FF FF FF FF 89 EO 00 00 02 

• ADF2: AO 00 00 00 09 00 05 FF FF FF FF 89 DO 00 00 02 

Under the MF, the mandatory files defined in TS 102 221 [5] are present, as the DFtelecom with the EFsume as defined 
in TS 102 222 [7] and some other files necessary for the tests. 

The files defined for ADFl and ADF2 are only necessary for the tests. 

All files are shareable if not specified otherwise. 

Except if specified the access conditions on DFs shall be set to ALWAYS for all commands. 

The global directory structures are defined in figures B.l to B.3: 
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MF 
'3F00 ' 






















1 




1 










1 




1 






DFtelecom 
'7F10' 




DFtest 
7F4A 




EFmcc 
'2FE4 ' 




EFdir 
'2F00 ' 




EFpL 
'2F05' 




EFicciD 
'2FE2 ' 




EFarr 

'2F06 ' 


































EFstjME 

'6F54' 


























EFtnr 
'6F01' 




EFthu 
'6F02 ' 




EF-TAmj 
'6F03 ' 




EFqjr 
'6F04' 




EFcNu 
'6F05 ' 


























































DFgnB TEST 

'5F10' 






EFcNic 
'6F1C' 




EFcNDE 

'6F07' 




EFcHflc 
'6F08' 




EFcARu 
'6F09' 




EFlnr 
'6F0A' 




















































'4F10' 






EFlhu 
'6F0B' 




EFlaru 
'6F0C' 




EFqha 
'6F0D' 




EFteac 
'6F0E' 




EFtdac 
'6F0F' 






















































EFciflc 
'6F10' 




EFciAA 

'6F11' 




EFcHRA 

'6F12' 




EFcnAC 
'6F13' 




EFtaac 
'6F14' 




















































EFlada 
'6F15' 




EFtaaa 
'6F16' 




EFlrha 
'6F17' 




EFmpc 
'6F18' 




EFhosh 
'6F19' 






































1 












EFlsea 
'6F1A' 




EFcsEA 

'6F1B' 




EFterm 
'6F30 ' 




I-'Pterm 
'5F30' 




















































EFlarri 
'6FA1' 




EFlaEr2 

'6FA2 ' 




EFlarr3 

'6FA3 ' 




EFlarr4 

'6FA4' 




EFlaRR5 

'6FA5 ' 




















































EFtarri 
'6FB1' 




EFtai(k2 

•6FB2' 




EFtarr3 

'6FB3' 




EFtarr4 

'6FB4 ' 




EF-tarrb 
'6FB5' 




















































EFcARRi 
'6FC1' 




EFcAER2 

'6FC2 ' 




EFcARR3 

'6FC3 ' 




EFcARR4 

'6FC4 ' 




EFcarR5 

'6FC5 ' 




























































DFflRRl 

'5F11' 




DFarr2 

'5F12 ' 




DFarr3 

'5F13 ' 




DFflEE4 

'5F14 ' 




DEarr5 
'5F15' 


































EFtarit 
'4F11' 




EFtar2T 

'4F12 ' 




EFtar3T 

'4F13 ' 




EFtar4T 

'4F14 ' 




EFtarbt 
'4F15 ' 



NOTE: Files with shaded bacl<ground are mandatory and defined in TS 1 02 221 [5]. 

Figure B.I : File identifiers and directory structures under MF 
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ADFl 

' XX...XX ' 








































DFtelecom 
' 7F10' 




DFtest 
'7F4A' 




EFuicc 
'2FE4 ' 




FF^RR 

'6F06' 




























EFsn„E 
'6F54 ' 




























EFthr 
'6F01' 




EFtnu 
'6F02' 




FFTflEn 
'6F03' 




EFcHR 
'6F04 ' 




EFcNu 
'6F05' 








































1 




1 




1 




1 






DFsnB TEST 

'5F10' 






FFcNic 
'6F1C' 




FFcHDE 

'6F07' 




EFcHAC 

'6F08' 




EFcflEn 
'6F09' 




EFlne 
'6F0A' 




















































'4F10' 






EFlhu 
'6F0B' 




FFlaru 
'6F0C' 




EFciHA 

'6F0D' 




EFteac 
'6F0E' 




EFtdac 
'6F0F' 






















































EFciAc 
'6F10' 




FFciAA 

'6F11' 




EFcNEA 

'6F12' 




EFcuAC 
'6F13' 




EFtaac 
'6F14 ' 






























1 


















EFlada 
'6F15' 




EFtaaa 
'6F16' 




EFlrua 
'6F17' 




EFlupc 
'6F18' 




EFhosh 
'6F19' 


















































EFlsea 
'6F1A' 




FFcSEA 

'6F1B' 




EFterm 
'6F30' 




DF^EEM 

'5F30' 






























1 




1 




1 




1 










EFlarri 

'6FA1' 




EFlarr2 

'6FA2 ' 




EFlarr3 

'6FA3 ' 




EFLaRR4 
'6FA4 ' 




EFlaeR5 

'6FA5 ' 




















































EFtarri 
'6FB1' 




EFTflRE2 

'6FB2' 




EFtarr3 

'6FB3' 




EFtarr4 

'6FB4 ' 




EF-rflER5 
'6FB5' 




















































EFcARRl 

'6FC1' 




EFcflRE2 

'6FC2' 




EFcARR3 

'6FC3' 




EFcARR4 

'6FC4' 




FFcarr5 

'6FC5' 




























































'5F11' 




DFftRR2 

'5F12 ' 




DFarr3 

'5F13 ' 




DFflEE4 

'5F14 ' 




DF_RRR5 

'5F15' 


































EFtarit 
'4F11' 




EFTflR2T 

'4F12 ' 




EFtar3T 

'4F13 ' 




EFtar4T 

'4F14 ' 




EFtaest 
'4F15 ' 



Figure B.2: File identifiers and directory structures under ADFl 
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ADF2 

' XX...XX ' 




























FFujcc 
'2FE4 ' 




DFtest 
1 7F4A' 




DFadf2 

'7F4B' 
















DFsuB TEST 

'5F10' 














EFtaa 
'4F10' 





Figure B.3: File identifiers and directory structures under ADF2 

Application PIN 1 (Global PIN 1) shall be associated to ADFl. 

Second Application PIN 1 (Local PIN 1) shall be associated to ADFl. 

The value for Application PIN 1 (Global PIN 1) shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state 
shall be 'disabled' during test applets execution. 

The value for Second Application PIN l(Local PIN 1) shall be "0x31 0x32 0x33 0x34 OxFF OxFF OxFF OxFF" and its 
state shall be 'enabled' during test applets execution. 

The value for ADMl shall be "0x31 0x31 0x31 0x31 0x31 0x31 0x31 0x31" and its state shall be 'enabled' during test 
applets execution. 

The value for ADM2 shall be "0x32 0x32 0x32 0x32 0x32 0x32 0x32 0x32" and its state shall be 'enabled' during test 
applets execution. 



B.1 UICC file system server mandatory pre- 
personalization 

Table B.l shows the mandatory pre-personalization, the file system and the files' content, that the test UICC cards shall 
contain. 

Table B.l 



Name 


Identifier 


Default Value 


Special Features 


EFicciD 


2FE2 


OF FF FF FF FF FF FF FF FF FF 


This value is not compliant with 
TS 102 221 [5] 


EFdir 


2F00 


Record 1: 61 12 4F 10 AID_1 
Record 2: 61 12 4F 10 AID 2 




EFPL 


2F05 


01 FF 




thsume 


6F54 


85 09 55 49 43 43 20 54 45 53 54 FF 
FF FF FF FF FF 


Under DF Telecom, compliant with 
TS 102 222 [7] 



MP 



EF ICCID 

EFDIR 

EFPL 

DF TELECOM 



EFSUIVIE 
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B.2 UICC file system server test default pre- 
personalization 

Figure B.l shows the additional pre-personahzation, the file system and files' content under the Master File, that the test 
UICC card shall contain. 



B.2.1 EFuicc (UICC Test EF) 



IVIF 



EF UICC 





Identifier: '2FE4' Structure: transparent 


IVIandatory 




File size: 3 bytes | Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.2 EFarr (UICC Test Access Rules EF) 



IVIF 



EFARR 



Identifier: '2F06' Structure: Linear fixed 


Optional 


SFI : none 




Record length : n bytes 


Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 ton 


Access Rule 1 


Always for all commands 


M 


n bytes 


n+1 to 2n 


Access Rule 2 


Never for all commands 


M 


n bytes 


2n+1 to 3n 


Access Rule 3 


Global PIN1 & ADIVI1 for all commands 


M 


n bytes 


3n+1 to 4n 


Access Rule 4 


Global PIN1 1 ADIVII for all commands 


M 


n bytes 


4n+1 to 5n 


Access Rule 5 


ADIVI2 for all commands 


M 


n bytes 
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Access rules definition: 



Record 
nb 


Delete selft 


Terminat 

card 

Usage/ 

Terminate 

DF 


Activate 
File 


Deactivate 
File 


Create File 

(DF 
creation) 


Create File 

(EF 
creation) 


Delete File 
(child) 




Delete File 


Terminate 
EF 


Activate 
File 


Deactivate 
File 


Write 
Binary, 

Write 
Record, 
Append 
Record 


Update 
Binary, 
Update 
Record, 
Erase 
Binary 


Read 
binary. 

Read 
Record, 
Search 
Binary, 
Search 
Record 


Increase, 
resize 


1 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


2 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


3 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADIVI1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


4 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


5 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 


ADM2 



B.2.3 DFjEST (UICC Access Tests DF) 



Identifier: 7F4A' 
MF 



DF TEST 



B.2.3. 1 EFtnr (Transparent Never Read) 



MF 



DETEST 



EFTNR 





Identifier: '6F01' 1 Structure: transparent 


IVIandatory 


SFI:'01' 




File size: 3 bytes 


Update activity 


: low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 
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B.2.3.2 EFtnu (Transparent Never Update) 



MF 



DF TEST 



EFTNU 





Identifier: '6F02' | Structure: transparent 


IVIandatory 


SFI: '02' 




File size: 3 bytes 


Update activity 


: low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


55 55 55 


M 


3 bytes 



B.2.3.3 EFtaru (Transparent Always Read and Update) 



IVIF 



DFTEST 



EF TARU 





Identifier: '6F03' 1 Structure: transparent 


IVIandatory 


SFI: '03' 




File size: 260 bytes 


Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 260 


Test Data 


FF... FF 


M 


260 bytes 



B.2.3.4 EFcNR (Cyclic Never Read) 



MF 



DF TEST 



EFCNR 



Identifier: '6F04' 


1 Structure: cyclic 


1 


Mandatory 


SFI: '04' 




Record length: 3 bytes 


Update activity: high 


Access Conditions: 
READ NEVER 
UPDATE ALWAYS 
INCREASE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 
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B. 2.3.5 EFcNu (Cyclic Never Update) 

IVIF 



DFTEST 



EFCNU 



Identifier: '6F05' 


1 Structure: cyclic 


1 


Mandatory 


SFI: '05' 




Record length: 3 bytes 


Update activity: high 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INCREASE NEVER 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.6 EFcNic (Cyclic Never Increase) 

MF 



DF TEST 



EFCNIC 



Identifier: '6F1C' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE NEVER 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


GG 00 00 


M 


3 bytes 


2 


Test Data 


GG 00 00 


M 


3 bytes 



B.2.3.7 EFcNDE (Cyclic Never Deactivate) 

MF 



DF TEST 



EFCNDE 
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Identifier: '6F07 Structure: cyclic IVIandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
DEACTIVATE NEVER 
ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



B. 2.3.8 EFcNAc (Cyclic Never Activate) 



MF 



DF TEST 



EF CNAC 



Identifier: ' 


6F08' 




Structure: cyclic 


1 


Mandatory 


Record 


length 


3 bytes 


1 Update activity: 


high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE NEVER 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



B. 2.3.9 EFcARu (Cyclic Always Read and Update) 



MF 



DF TEST 



EF CARU 



Identifier: '6F09' 


Structure: cyclic 


1 


Mandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 






READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






DEACTIVATE 


ALWAYS 






ACTIVATE 


ALWAYS 






Logical Record 


Description 


Default Value 


M/0 


Length 


Number 










1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AA AA AA 


M 


3 bytes 
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B. 2.3. 10 EFlnr (Linear Fixed Never Read) 



IVIF 



DF TEST 



EFLNR 



Identifier: '6F0A' 


Structure: linear fixed 


IVIandatory 


Record length: 4 bytes 


1 Update activity: 


low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



B.2.3.1 1 EFlnu (Linear Fixed Never Update) 

IVIF 



DF TEST 



EFLNU 



Identifier: '6F0B' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


1 Update activity: 


low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

DEACTIVATE ALWAYS 

ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



B.2.3.1 2 EFlaru (Linear Fixed Always Read and Update) 



MF 



DF TEST 



EF LARU 



Identifier: '6F0C' 


Structure: linear fixed 


Mandatory 


Record length: 4 bytes 


1 Update activity: 


low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AA AA AA AA 


M 


4 bytes 
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B. 2.3. 13 EFciNA (Cyclic Increase Not Allowed) 

IVIF 



DFTEST 



EFCINA 



Identifie 


r: '6F0D' 


1 


Structure: cyclic | 


IVIandatory 


Record length: 3 bytes 




Update activity: high 






Access Conditions: 
READ 
UPDATE 
INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
NEVER 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.14 EFtrac (Transparent Read Access Condition ADM 2) 



MF 



DF TEST 



EF TRAC 



Identifier: '6F0E' 


Structure: transparent | 


Mandatory 


File size: 3 bytes 


1 


Update activity: 


ow 


Access Conditions: 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ADM 2 
ALWAYS 
ALWAYS 
ALWAYS 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.15 EFtdac (Transparent Deactivate Access Condition Application PIN 1) 



MF 



DFTEST 



EF TDAC 



Identifier: '6F0F' 


Structure: transparent | 


Mandatory 


File size: 3 bytes 


1 


Update activity: 


ow 


Access Conditions: 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ALWAYS 

ALWAYS 

Application PIN 1 

ALWAYS 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 



ETSI 



Release 6 



746 



ETSI TS 102 268 V6.1.0 (2013-06) 



B. 2.3. 16 EFciAc (Cyclic Increase Access Condition ADM 2) 



IVIF 

MF 
1 DFTESl 


r 

EFC 


:iAC 


















Identifie 


r:'6F10' 




Structure: cyclic | 


Mandatory 


Record length 


: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 

INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 

ADM 2 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



B.2.3.17 EFciAA (Cyclic Increase Access Condition ADM 1) 

MF 



DF TEST 



EF CIAA 



Identifie 


r:'6F11' 




Structure: cyclic | 


Mandatory 


Record length 


: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
ADM1 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 
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B. 2.3. 18 EFcNRA (Cyclic Never Activate) 



MF 



DF TEST 



EFCNAC 



Identifie 


r:'6F12' 




Structure: cyclic | 


Mandatory 


Record length 


: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
ALWAYS 
ALWAYS 
NEVER 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



The Operational state bit of Life Cycle Status Integer shall be DEACTIVATED as defined in TS 102 221 [5]. 

B.2.3.19 EFcuAc (Cyclic Update Access Condition Application PIN 1) 



MF 



DF TEST 



EF CUAC 



Identifier: '6F1 3' 


Structure: cyclic Mandatory 


Record length: 3 bytes 


Update activity: high 


Access Conditions: 

READ Application PIN 1 

UPDATE Application PIN 1 

INCREASE Application PIN 1 

DEACTIVATE ADM 1 

ACTIVATE ADM 1 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 


3 


Test Data 


00 GG GG 


M 


3 bytes 
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B.2.3.20 EFtaac (Transparent Activate Access Condition Application PIN 1) 



IVIF 



DFTEST 



EF TAAC 



Identifier: '6F14' Structure: transparent 


Mandatory 


File size: 3 bytes Update activity: h 


ligh 


Access Conditions: 

READ Application PIN 1 
UPDATE ADM 1 
DEACTIVATE ADM 1 

ACTIVATE Application PIN 1 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B.2.3.21 EFlada (Linear Fixed Activate Deactivate Access Condition ADM 2) 

MF 



DF TEST 



EF LADA 



Identifier: '6F1 5' Structure: linear fixed Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 

READ Application PIN 1 

UPDATE Application PIN 1 

DEACTIVATE ADM 2 

ACTIVATE ADM 2 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B.2.3.22 EFtaaa (Transparent All Access Conditions ADM 1) 



MF 



DF TEST 



EF TAAA 



Identifier: '6F1 6' 


Structure 


;: transparent 


Mandatory 


File size: 3 bytes 


1 


Update activity: f 


ligh 


Access Conditions: 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ADM1 
ADM1 
ADM1 
ADM1 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 
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B.2.3.23 EFlrua (Linear Fixed Read Update Access Condition Application 
PIN 1) 



MF 



DF TEST 



EF LRUA 



Identifie 


r:'6F17' 




Structure: linear fixed | 


Mandatory 


Record length 


: 3 bytes 


1 


Update activity: h 


igh 






Access Conditions: 
READ 
UPDATE 

DEACTIVATE 

ACTIVATE 


Application PIN 1 
Application PIN 1 

ADM1 

ADM1 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B.2.3.24 EFlupc (Linear Fixed Update Access Condition ADM 2) 

MF 



DF TEST 



EF LUPC 



Identifier: '6F1 8' Structure: linear fixed Mandatory 


Record length: 1 bytes Update activity: high 


Access Conditions: 

READ Application PIN 1 

UPDATE ADM 2 

DEACTIVATE ADM 1 

ACTIVATE ADM 1 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 ... 11 


M 


10 bytes 


2 


Test Data 


22 ... 22 


M 


10 bytes 



B. 2.3.25 EFnosh (Not Shareable) 



MF 



DFTEST 



EF NOSH 



Identifier: '6F1 9' 


Structure 


: transparent 


Mandatory 


File size: 3 bytes 


1 


Update activity: h 


ligh 


Access Conditions: 

NOT SHAREABLE 
READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
ALWAYS 
ALWAYS 




Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 
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B.2.3.26 EFlsea (Linear File for SearclnRecord tests) 



IVIF 



DFTEST 



EF LSEA 



Identifier: '6F1 A' Structure: Linear Fixed Mandatory 


Record length: 1 5 bytes Update activity: high 


Access Conditions: 

READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


01 02 03 04 05 06 07 08 09 OA 
OBOCODOEOF 


M 


1 5 bytes 


2 


Test Data 


OA OB OC OD OE OF 01 02 03 04 
05 06 07 08 09 


M 


1 5 bytes 


3 


Test Data 


04 05 06 07 08 09 OA OB OC OD 
0E0F01 02 03 


M 


1 5 bytes 


4 


Test Data 


07 08 09 OA OB OC OD OE OF 01 
02 03 04 05 06 


M 


1 5 bytes 


5 


Test Data 


OA 01 02 03 OB 01 02 03 OC 01 
02 03 OD 01 02 


M 


1 5 bytes 


6 


Test Data 


03 02 01 03 02 01 03 02 01 03 
02 01 03 02 01 


M 


1 5 bytes 



B.2.3.27 EFcsEA (Cyclic File for SearchRecord tests) 



MF 



DF TEST 



EF CSEA 



Identifier: '6F1B' Structure: Cyclic IVIandatory 


Record length: 1 5 bytes Update activity: high 


Access Conditions: 

READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


01 02 03 04 05 06 07 08 09 OA 
OBOCODOEOF 


M 


1 5 bytes 


2 


Test Data 


OA OB OC OD OE OF 01 02 03 04 
05 06 07 08 09 


M 


1 5 bytes 


3 


Test Data 


04 05 06 07 08 09 OA OB OC OD 
0E0F01 02 03 


M 


1 5 bytes 


4 


Test Data 


07 08 09 OA OB OC OD OE OF 01 
02 03 04 05 06 


M 


1 5 bytes 


5 


Test Data 


OA 01 02 03 OB 01 02 03 OC 01 
02 03 OD 01 02 


M 


1 5 bytes 


6 


Test Data 


03 02 01 03 02 01 03 02 01 03 
02 01 03 02 01 


M 


1 5 bytes 
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B. 2.3.28 EFterm (Terminated) 

MF 



DFTEST 



EFTERM 



Identifier: '6F30' Structure 


: Transparent Mandatory 


File size: 3 bytes 


Update activity: low 


LCSI: 




TERMINATED 




Access Conditions: 




READ 
UPDATE 
DEACTIVATE 
ACTIVATE 


ALWAYS 
ALWAYS 
ALWAYS 
ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


FF FF FF 


M 


3 bytes 



B. 2.3.29 DFterm (DP Terminated) 

Identifier: '5F30' 

Access Conditions: Record 1 of EFARR (0x2F06 under MF and 0x6F06 under ADFl) 

Life Cycle Status Information: Terminated 

MF 



DF TEST 



DFTERM 



B.2.3.30 EFlarri (Linear Fixed on Access Rule Reference 1) 



MF 



DF TEST 



EF LARR1 



Identifier: '6FA1' Structure: linear fixed Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 1 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 
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B.2.3.31 EFlarr2 (Linear Fixed on Access Rule Reference 2) 



MF 



DF TEST 



EF LARR2 



Identifier: '6FA2' Structure: linear fixed 


Mandatory 


Record length: 3 bytes Update activity: f 


igh 


Access Conditions: 
Record 2 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.32 EFlarr3 (Linear Fixed on Access Rule Reference 3) 



MF 



DF TEST 



EF LARR3 



Identifier: '6FA3' Structure: linear fixed Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 3 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.33 EFlarr4 (Linear Fixed on Access Rule Reference 4) 



MF 



DFTEST 



EF LARR4 



Identifier: '6FA4' Structure: linear fixed 


Mandatory 


Record length: 3 bytes Update activity: f 


igh 


Access Conditions: 
Record 4 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 
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B.2.3.34 EFlarrs (Linear Fixed on Access Rule Reference 5) 

MF 



DF TEST 



EF LARR5 



Identifier: '6FA5' Structure: linear fixed 


Mandatory 


Record length: 3 bytes Update activity: f 


igh 


Access Conditions: 
Record 5 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.35 EFtarri (Transparent on Access Rule Reference 1) 



MF 



DF TEST 



EFTARRI 



Identifier: '6FB1' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 1 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 



B.2.3.36 EFtarr2 (Transparent on Access Rule Reference 2) 



MF 



DFTEST 



EF TARR2 



Identifier: '6FB2' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 2 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 
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B.2.3.37 EFtarrs (Transparent on Access Rule Reference 3) 



MF 



DF TEST 



EF TARR3 



Identifier: '6FB3' Structure: transparent 


Mandatory 


File size: 5 bytes Update activity: h 


ligh 


Access Conditions: 
Record 3 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 



B.2.3.38 EFtarr4 (Transparent on Access Rule Reference 4) 



MF 



DF TEST 



EF TARR4 



Identifier: '6FB4' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 4 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 



B.2.3.39 EFtarrs (Transparent on Access Rule Reference 5) 



MF 



DFTEST 



EF TARR5 



Identifier: '6FB5' Structure: transparent Mandatory 


File size: 5 bytes Update activity: high 


Access Conditions: 
Record 5 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 11 11 


M 


5 bytes 
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B.2.3.40 EFcARRi (Cyclic Access Rule Reference 1) 



MF 



DF TEST 



EFCARRI 



Identifier: '6FCr Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: h 


igh 


Access Conditions: 
Record 1 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.41 EFcARR2 (Cyclic Access Rule Reference 2) 

MF 



DF TEST 



EF CARR2 



Identifier: '6FC2' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 2 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.42 EFcARR3 (Cyclic Access Rule Reference 3) 



MF 



DFTEST 



EF CARR3 



Identifier: '6FC3' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: h 


igh 


Access Conditions: 
Record 3 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 
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B.2.3.43 EFcARR4 (Cyclic Access Rule Reference 4) 



MF 



DF TEST 



EF CARR4 



Identifier: '6FC4' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: h 


igh 


Access Conditions: 
Record 4 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.3.44 EFcARRs (Cyclic Access Rule Reference 5) 

MF 



DF TEST 



EF CARR5 



Identifier: '6FC5' Structure: cyclic Mandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
Record 5 of EFarr 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


11 11 11 


M 


3 bytes 


2 


Test Data 


22 22 22 


M 


3 bytes 



B.2.4 DF suB_TEST (Test DF under DF TEST) 

Identifier: '5F10' 



MF 



DFTEST 



DF SUB TEST 
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B.2.4.1 EFtaa (Test EF) 

IVIF 



DF TEST 



DFSUB TEST 



EFTAA 





Identifier: '4F1 0' Structure: transparent 


IVIandatory 




File size: 3 bytes 1 Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.5 DFarri (DF Access Rule Reference 1) 

Identifier: 'SFll' 

Access Conditions: Record 1 of EFARR (0x2F06 under the MP and 0x6F06 under ADFl). 

MF 



DFTEST 



DFARRI 



B.2.5. 1 EFtarit (Transparent Access Rule 1 Test EF) 



MF 



DFTEST 



DFARRI 



EFTAR1T 





Identifier: '4F11' 


Structure: transparent IVIandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 1 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



ETSI 



Release 6 



758 



ETSI TS 102 268 V6.1.0 (2013-06) 



B.2.6 DFarr2 (DF Access Rule Reference 2) 

Identifier: '5F12' 

Access Conditions: Record 2 of EFARR (0x2F06 under the MP and 0x6F06 under ADFl). 

MF 



DFTEST 



DFARR2 



B.2.6. 1 EFtar2t (Transparent Access Rule 2 Test EF) 



MF 



DF TEST 



DF ARR2 



EF TAR2T 





Identifier: '4F1 2' 


Structure: transparent 


Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 2 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.7 DFarrs (DF Access Rule Reference 3) 

Identifier: '5F13' 

Access Conditions: Record 3 of EFARR (0x2F06 under the MF and 0x6F06 under ADFl). 

MF 



DF TEST 



DF ARR3 



B.2.7. 1 EFtar3t (Transparent Access Rule 3 Test EF) 



MF 



DF TEST 



DFARR3 



EF TAR3T 





Identifier: '4F1 3' 


Structure: transparent Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 3 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



ETSI 



Release 6 



759 



ETSI TS 102 268 V6.1.0 (2013-06) 



B.2.8 DFarr4 (DF Access Rule Reference 4) 

Identifier: '5F14' 

Access Conditions: Record 4 of EFARR (0x2F06 under the MP and 0x6F06 under ADFl). 

MF 



DFTEST 



DFARR4 



B.2.8. 1 EFtar4t (Transparent Access Rule 4 Test EF) 



MF 



DF TEST 



DF ARR4 



EF TAR4T 





Identifier: '4F14' 


Structure: transparent 


Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 4 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



B.2.9 DFarrs (DF Access Rule Reference 5) 

Identifier: '5F15' 

Access Conditions: Record 5 of EFARR (0x2F06 under the MF and 0x6F06 under ADFl). 

MF 



DF TEST 



DF ARR5 



B.2.9. 1 EFtarst (Transparent Access Rule 5 Test EF) 



MF 



DFTEST 



DFARRS 



EF TAR5T 





Identifier: '4F15' 


Structure: transparent Mandatory 




File size: 3 bytes 


1 Update activity: low 


Access Conditions: 
Record 5 of EFarr 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 
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B.3 First application dedicated files system ADF1 

The prepersonalization of UlCC cards shall contain ADFl. 

Figure B.2 shows the additional prepersonalization, the file system and files' content under ADFl system. 

All the files are defined as in the UICC file system server. 



B.3.1 DFjELECOM 



Identifier: 7F10' 



ADFl 



DP TELECOM 



B. 3.4.1 EFsuME(EFSetUpMenu) 

ADP1 



DP TELECOM 



EPSUME 



Identifier: '6P54' Structure: transparent Mandatory 


Pile size: 1 7 bytes Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 17 


Test Data 


85 09 55 49 43 43 20 54 45 53 54 PP PP 
PP PP PP PP 


M 


1 7 bytes 



B.3.4.2 EFarr (UICC Test Access Rules EF) 



MP 



EPARR 



Identifier: '6P06' Structure: Linear fixed | Optional 


SPI : none 




Record length : n bytes 


Update activity: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/O 


Length 


1 ton 


Access Rule 1 


Always for all commands 


M 


n bytes 


n+1 to 2n 


Access Rule 2 


Never for all commands 


M 


n bytes 


2n+1 to 3n 


Access Rule 3 


Global PIN1 & ADM1 for all commands 


M 


n bytes 


3n+1 to 4n 


Access Rule 4 


Global PIN1 1 ADM1 for all commands 


M 


n bytes 


4n+1 to 5n 


Access Rule 5 


Local PIN1 for all commands 


M 


n bytes 
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Access rules definition: 



Record 
nb 


Delete selft 


Terminat 

card 

Usage/ 

Terminate 

DF 


Activate 
File 


Deactivate 
File 


Create File 

(DF 
creation) 


Create File 

(EF 
creation) 


Delete File 
(child) 




Delete File 


Terminate 
EF 


Activate 
File 


Deactivate 
File 


Write 
Binary, 

Write 
Record, 
Append 
Record 


Update 
Binary, 
Update 
Record, 
Erase 
Binary 


Read 
binary. 

Read 
Record, 
Search 
Binary, 
Search 
Record 


Increase, 
resize 


1 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


Always 


2 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


Never 


3 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


Global PIN1 
&ADM1 


4 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global P1N1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


Global PIN1 
1 ADM1 


5 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 


Local PIN1 



B.4 Second application dedicated files system ADF2 

The prepersonalization of UICC cards shall contain ADF2. 

Figure B.3 shows the additional prepersonalization, the file system and files' content under ADF2 system. 



B.4.1 EFuicc (UICC Test EF) 



ADF2 



EFUICC 





Identifier: '2FE4' Structure: transparent 


Mandatory 




File size: 3 bytes 1 Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


CC CC CC 


M 


3 bytes 



B.4.2 DFjEST (1 St Test DF under ADF2) 

Identifier: 7F4A' 



ADF2 



DF TEST 
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B.4.2.1 DFsuB.TEST (1 DF under DF_TEST) 

Identifier: '5F10' 



ADF2 



DF TEST 



DF SUB TEST 



B.4.2.1.1EFTAA(TestEF) 





Identifier: '4F10' Structure: transparent 


IVIandatory 




File size: 3 bytes 1 Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
DEACTIVATE ALWAYS 
ACTIVATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 to 3 


Test Data 


AA AA AA 


M 


3 bytes 



ADF2 



DFTEST 



DF SUB TEST 



EFTAA 



»nd 



B.4.3 DFadf2 (2"° Test DF under ADF2) 



Identifier: 7F4B' 
ADF2 



DF ADF2 
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Annex C (normative): 
Test file description 



Every test source is written in javaT"^ and shall use methods defined in Annex D interfaces to communicate with the 
card, or to check status word or received data. 

In order to be more readable, data specified as method string parameters shall be presented in 4 blocks of 4 bytes per 
line. Every block is separated by a space character. Every string line is appended to previous one and shall be aligned. 
An example is provided in Annex D. 

Every test file shall start with a call to reset() method. 

Except otherwise stated, each reset() method shall be followed by a profile download. 
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Annex D (normative): 

uicc.test.util package, Uicc interfaces and testing script 

example 

See attached files contained in ts_102268v060100p0.zip: 

• Annex_D_UiccTestUtil.zip 

• Annex_D_UiccInterfaces.zip 

• Annex_D_Example.zip 
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Annex E (normative): 
Test Area files 

See attached file contained in ts_102268v060100p0.zip: 
• Annex_E_SourceCode.zip 
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Annex G (informative): 
Change history 



The table below indicates all changes that have been made to the present document since first publication. 
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F 
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